IDZ DO

PRZYKADOWY ROZDZIA
SPIS TRECI

KATALOG KSIEK
KATALOG ONLINE
ZAMW DRUKOWANY KATALOG

Visual Basic .Net.

Szybki start
Autor: Harold Davis
Tumaczenie: Krzysztof Jurczyk, Tomasz Walczak
ISBN: 83-7361-737-X
Tytu oryginau: Visual Basic .Net
for Windows Visual Quickstart Guide
Format: B5, stron: 600

TWJ KOSZYK
DODAJ DO KOSZYKA

CENNIK I INFORMACJE
ZAMW INFORMACJE
O NOWOCIACH
ZAMW CENNIK

CZYTELNIA
FRAGMENTY KSIEK ONLINE

Wydawnictwo Helion
ul. Chopina 6
44-100 Gliwice
tel. (32)230-98-63
e-mail: helion@helion.pl

Kurs tworzenia aplikacji WWW w jzyku Visual Basic .NET

Visual Basic od dawna cieszy si uznaniem wrd informatykw. Wedug ostatnich
bada, jest wykorzystywany przez ponad 5 milionw programistw z caego wiata.
Visual Basic jest niezwykle atwy do opanowania, a jednoczenie posiada ogromne
moliwoci i elastyczno. Jego najnowsza wersja Visual Basic .NET otwiera przed
twrcami oprogramowania nowe horyzonty zwizane z platform .NET szybki
i wydajny dostp do baz danych, stosowanie jzyka XML oraz moliwo tworzenia
aplikacji typu Web Services to tylko niektre z nich. Jzyk VB .NET jest potnym,
eleganckim i w peni obiektowym nowoczesnym jzykiem programowania, w ktrym
jednak zostaa zachowana prostota, ktra zawsze bya cech charakterystyczn
jzykw z rodziny Basic.
Visual Basic .NET. Szybki start to ksika dla tych, ktrzy chc pozna moliwoci
najnowszej wersji Visual Basica bez koniecznoci przebijania si przez tysice linii
przykadowych kodw i setki stron opisw. Kade z omawianych zagadnie
przedstawione jest w postaci sekwencji czynnoci opatrzonej ilustracjami.
Nie znajdziesz tu rozwaa teoretycznych -- poznasz tajniki rodowiska .NET,
obiektw i programowania poprzez rozwizywanie przykadowych zagadnie.
rodowisko Visual Studio .NET
Projektowanie aplikacji Web Services
Klasy i obiekty
Tworzenie formularzy Windows
Okna komunikatw
Praca z formularzami MDI
Obsuga wyjtkw i usuwanie bdw
Stosowanie komponentw
Dodawanie menu do aplikacji
Bazy danych oraz technologie ADO.NET i XML
Aplikacje internetowe ASP.NET

Poznaj jzyk Visual Basic szybko i bez problemw.

Docz do ogromnej spoecznoci programistw VB.NET

Spis treci

Spis treci
Wprowadzenie

Poznajemy Visual Studio .NET

15
Strona startowa..........................................................................................16
Konfigurowanie rodowiska Visual Studio .NET .....................................22
Solucje, projekty i moduy ........................................................................26
Narzdzia rodowiska Visual Studio.........................................................36

Rozdzia 2.

Tworzenie usug Web Service

43
Poznajemy usugi Web Service ................................................................44
Tworzenie usugi Web Service..................................................................47
Testowanie usug Web Service .................................................................52
Dodawanie metod Web .............................................................................53
Testowanie metody Web ...........................................................................54

Rozdzia 3.

Praca z klasami
55
Poznajemy obiekty i klasy.........................................................................56
Dodawanie klasy do usugi Web Service ..................................................58
Dodawanie klasy do aplikacji Windows ...................................................67
Skadowe klasy..........................................................................................78
Zasig ........................................................................................................90
Przecianie metody..................................................................................92
Konstruktory klasy ....................................................................................94
Dziedziczenie ............................................................................................96
Dziedziczenie wizualne.............................................................................99

Rozdzia 4.

Interfejsy klasy
101
Abstrakcyjne klasy bazowe .....................................................................102
Interfejsy klasy ........................................................................................111
Tworzenie wasnego interfejsu klasy ......................................................118

Rozdzia 5.

Formularze Windows
125
Klasa Form ..............................................................................................126
Waciwoci formularza ..........................................................................133
Zmiana ksztatu formularza.....................................................................151
5

Spis treci

Rozdzia 1.

Spis treci

Spis treci

Praca z egzemplarzami formularza .........................................................154

Uruchamianie aplikacji z Sub Main ........................................................167
Rozdzia 6.

Uywanie usug Web Service

173
Tworzenie interfejsu uytkownika ..........................................................174
Sprawdzanie poprawnoci danych wprowadzanych przez uytkownika.....177
Dodawanie odnonika do usugi Web Service ........................................180
Uywanie usugi......................................................................................182

Rozdzia 7.

Okna komunikatu i instrukcja If

187
Klasa MessageBox ..................................................................................188
Tworzenie interfejsu uytkownika ..........................................................208
Stosowanie instrukcji If...........................................................................214
Podczanie formularza ...........................................................................215

Rozdzia 8.

Praca z formularzami MDI

225
Uywanie formularza nadrzdnego.........................................................227
Uywanie formularzy potomnych ...........................................................230
Uywanie tablic.......................................................................................237
Klasy pojemnikowe Collection ...............................................................245

Rozdzia 9.

Wyjtki i usuwanie bdw

247
Strukturalna obsuga wyjtkw ...............................................................248
Uywanie instrukcji Try..........................................................................249
Generowanie wyjtkw...........................................................................261
Praca z obiektami Exception ...................................................................264
Uywanie okna dialogowego Exceptions................................................265
Poznajemy rne rodzaje bdw ...............................................................267
Korzystanie z metod obiektu Debug .......................................................270
Uywanie polece Step i Watch..............................................................273

Rozdzia 10. Kontrolki umoliwiajce interakcj z uytkownikiem

277
Dostosowanie paska narzdzi do wasnych wymaga ............................278
Polecenia menu Format ...........................................................................284
Praca z grupami kontrolek.......................................................................288
Praca z kontrolk paska narzdzi ToolBar ..............................................294
Uycie kontrolki ToolTip........................................................................303
Obsuga zakadek za pomoc kontrolki TabControl ...............................305
Korzystanie z kontrolki TrackBar ...........................................................311
Zarzdzanie listami za pomoc kontrolki ListBox..................................313

Spis treci

Rozdzia 11. Komponent Timer

331
Zasada dziaania komponentu Timer ......................................................332
Wywietlanie biecego czasu ................................................................337
Animacja duszka .....................................................................................342
Rozdzia 12. System menu
353
Dodawanie menu.....................................................................................354
Definiowanie nazw elementw menu .....................................................361
Doskonalenie systemu menu ...................................................................364
Obsuga zdarze dotyczcych menu .......................................................369
Modyfikacja menu za pomoc kodu aplikacji.........................................377
Dodawanie menu za pomoc kodu aplikacji ...........................................385
Implementacja menu w aplikacjach MDI................................................388

Rozdzia 14. Przegldarka obiektw Object Browser

437
Otwieranie przegldarki obiektw ..........................................................438
Interfejs przegldarki obiektw...............................................................442
Pakiety.....................................................................................................448
Przestrzenie nazw ....................................................................................451
Waniejsze przestrzenie nazw .NET .......................................................458
Rozdzia 15. XML, zbiory danych i ADO.NET
461
Praca z XML ..........................................................................................463
Praca z bazami danych ............................................................................483
Rozdzia 16. Aplikacje internetowe ASP.NET
513
Podstawy ASP.NET ................................................................................515
Warunki niezbdne do tworzenia aplikacji ASP.NET ...........................518
Tworzenie aplikacji internetowych ASP.NET ........................................519
Praca z kontrolkami.................................................................................530
Dodatek A

Pomoc w rodowisku Visual Studio

557
Korzystanie z systemu pomocy online....................................................558
Korzystanie z pomocy dynamicznej........................................................560
7

Spis treci

Rozdzia 13. Kontrolki Common Dialog

401
Przykadowa aplikacja.............................................................................403
Okno dialogowe Czcionka ......................................................................408
Okno dialogowe Kolor ............................................................................411
Okna dialogowe File ...............................................................................414
Korzystanie z obiektu FileStream ...........................................................423
Drukowanie .............................................................................................428

Spis treci

Korzystanie z okna zawartoci Contents.................................................561

Korzystanie z okna Index ........................................................................563
Korzystanie z okna Search ......................................................................564
Filtrowanie ..............................................................................................566
Dodatek B

Sowa kluczowe Visual Basic .NET

Dodatek C

Typy i konwersja typw

571
Typy Visual Basic .NET .........................................................................572
Opcja kompilatora Option Strict .............................................................574
Podstawy silnego typowania ...................................................................576
Korzystanie z konwersji niejawnej..........................................................579
Korzystanie z funkcji CType...................................................................580
Korzystanie z doczanych funkcji konwersji typw..............................581
Stosowanie innych metod konwersji.......................................................582

Spis treci

Skorowidz

569

585

Tworzenie usug
Web Service

Tworzenie usug Web Service

Rozdzia 2 . T wo rz enie usug W eb Se rv ice

Teraz, kiedy wiesz ju, jak porusza si

w rodowisku Visual Studio .NET, pora, aby
stworzy pierwszy program Visual Studio .NET.
Jedn z najbardziej spektakularnych cech
platformy .NET jest atwe i szybkie tworzenie
usug Web Service. Dlatego te pierwszym
programem, jaki utworzysz, bdzie opisana
w tym rozdziale usuga ASP.NET Web Services.

Tworzenie usug Web Service

43

Rozdzia 2.

Poznajemy usugi Web Service

Poznajemy usugi Web Service

Czym jest usuga Web Service? W najprostszej

postaci usuga Web Service dostarcza metody,
ktre mog by wywoane przez sie za pomoc
standardowych protokow, takich jak HTTP
(ang. Hypertext Transfer Protocol) oraz XML
(ang. eXtensible Markup Language). Metoda
jest to funkcja lub procedura, ktra zwizana
jest z danym obiektem. Innymi sowy, wywoanie
metody powoduje, e wykonywane jest okrelone
dla niej dziaanie.
Usugi Web Service s o tyle ciekawe, e
pozwalaj tworzy programy, ktre s cakowicie
midzyplatformowe. Programy te mog by
uruchamiane poprzez sie internetow niezalenie
od uytych do ich tworzenia narzdzi oraz
bez wzgldu na system, na jakim maj dziaa.
Inn charakterystyczn cech usug Web Service
jest to, e dostarczaj penej informacji
o wykonywanych dziaaniach. Oznacza to,
e mona sprawdzi, jakie s nazwy metod,
ktrych dana usuga dostarcza, jakie argumenty
przyjmuj poszczeglne metody oraz jakie
wartoci zwracaj. Jeli wic wie si, e dana
usuga Web Service istnieje, to mona z niej
korzysta w tworzonym programie
Celem, dla ktrego utworzono usugi
Web Service, jest dostarczenie komponentw
o specyficznych cechach. Komponenty
te mog si ze sob komunikowa niezalenie
od jzyka programowania, w ktrym zostay
napisane oraz bez wzgldu na system operacyjny,
na ktrym s uruchamiane. Metody tych
komponentw mog by uywane przez inne
programy. Aby uy usugi Web Service, program
wysya danie za pomoc protokou HTTP,
i aby posuy si konkretn metod, wywouje

,
 lub najczciej uywa
protokou SOAP (ang. Simple Object Access
Protocol).

44

Dziki platformie .NET programista nie musi

wgbia si w szczegy kodu protokou
SOAP. Poniewa jednak usugi Web Service
korzystaj z da protokou SOAP,
warto zapozna si z istot jego dziaania.
We wczeniejszym fragmencie znalaza si
informacja, e usugi Web Service dostarczaj
uniwersalnego mechanizmu, ktry informuje
o uywanych metodach. W celu implementacji
tego mechanizmu platforma .NET
automatycznie tworzy dokument w jzyku
WSDL (ang. Web Services Description
Language), ktry moe zosta odczytany
przez aplikacj lub czowieka. Dokument
ten pozwala zrozumie, jak dziaa dana
usuga Web Service. Platforma .NET
uwalnia programist od obowizku tworzenia
dokumentw WSDL, warto jednak wiedzie,
e taki dokument istnieje i do czego suy.
Usugi Web Service korzystaj take ze
standardu UDDI (ang. Universal Description,
Discovery and Integration). Standard ten jest
czym w rodzaju Panoramy Firm dla usug
Web Service. Jeli chcesz odnale usug
Web Service lub jeli chcesz, aby dana usuga
moga zosta odnaleziona, musisz skorzysta
ze standardu UDDI.
W nastpnych paragrafach przedstawione
zostan podstawowe cechy trzech gwnych
komponentw usug Web Service SOAP,
WSDL oraz UDDI. Podane take zostan
niezbdne informacje, potrzebne
do utworzenia zaawansowanej usugi
Web Service za pomoc platformy .NET.

Tworzenie usug Web Service

SOAP
Standard SOAP, kontrolowany przez
konsorcjum W3C (ang. World Wide Web
Consortium), jest oparty na standardzie XML.
Skada si z trzech czci:
u Otoczki (ang. envelope), ktra definiuje

reguy opisywania wiadomoci i ich

przetwarzania.
u Zestawu regu kodowania (ang. encoding

rules) struktur danych definiowanych

w aplikacjach.
u Konwencji (ang. convention)

reprezentowania zdalnych wywoa

procedur i ich odpowiedzi.

WSDL
Standard WSDL uywany jest do tworzenia
dokumentw, ktre opisuj metody obsugiwane
przez usug Web Service, argumenty
przyjmowane przez te metody oraz zwracane
przez nie wartoci. Innymi sowy dokument
WSDL przekazuje programowi lub programicie
wszystkie niezbdne informacje, potrzebne
do skorzystania z usugi.
Poniewa dokumenty WSDL odczytywane
s zwykle przez komputery, a nie przez
ludzi, musz by formuowane w sposb,
ktry pozwoli na ich przetwarzanie przez
oprogramowanie. Dlatego te dokumenty
WSDL tworzone s w oparciu o jzyk XML,
ktry suy do opisu formatu innych
dokumentw (w tym take i XML).

Jeli bdziesz chcia utworzy program VB .NET,

ktry uywa usug Web Service, ale ich nie
udostpnia, wtedy rodowisko Visual Studio
utworzy usug proxy w oparciu o dokument
WSDL dostarczony przez usug Web Service.
Klasa proxy zawiera kod, ktry pozwala na
uycie metod usug Web Service w kodzie
jzyka Visual Basic. Szczegowy opis znajduje
si w rozdziale 6. Uywanie usug Web Services.

UDDI
Jeli w lesie upado drzewo, ale nikt tego nie
widzia, to czy rzeczywicie upado? Ta sama
zagadka mogaby odnosi si do usug Web
Service. W tym przypadku istnieje jednak
standard UDDI, ktry przekazuje informacje
o istniejcych usugach.
Jeli na przykad dysponujesz usug Web
Service, ktrej mog uywa inne osoby,
moesz skorzysta z UDDI, aby umieci
usug na licie. Potencjalni uytkownicy
usug mog j tam znale. W podobny
sposb i Ty moesz znale potrzebn usug.
W przypadku standardw SOAP i WSDL
rodowisko .NET sprawia, e wystarczy
zrozumie tylko oglny sens ich dziaania.
Z kolei standard UDDI wymaga dziaania
programisty ju na wczesnych etapach pracy.

45

Poznajemy usugi Web Service

Jeli mylisz, e rczne tworzenie usug

Web Service, ktre bd zgodne ze standardem
SOAP, jest skomplikowane i mudne, to masz
cakowit racj. Na szczcie w trakcie tworzenia
usug Web Service w postaci projektu ASP.NET
w rodowisku Visual Studio nie trzeba wpisywa
kodu. Jeli jednak kto chce dowiedzie si
wicej o szczegach specyfikacji standardu
SOAP, moe zapozna si z nimi na stronie
http://www.w3.org/TR/SOAP/.

Przy tworzeniu usugi Web Service za pomoc

projektu ASP.NET w rodowisku Visual Studio
nie trzeba si martwi o tworzenie dokumentu
WSDL. Zajmuje si tym rodowisko Visual
Studio w momencie uruchamiania projektu
ASP.NET z usug Web Service. Wicej
informacji o standardzie WSDL mona znale
na stronie http://www.w3.org/TR/WSDL.

Rozdzia 2.

Aby znale usug Web Service:

1. Na stronie startowej rodowiska Visual

Studio na zakadce Online Resources

kliknij odnonik XML Web Services
(rysunek 2.1).
Pojawi si zakadka Find a Service.
2. Upewnij si, e zaznaczony jest przycisk

opcji UDDI Production Environment.

3. Wybierz kategori z listy rozwijanej

Category, na przykad Financial.

4. W polu tekstowym Search For wpisz

Poznajemy usugi Web Service

szukane pojcie lub zostaw pole puste,

jeli chcesz zobaczy wszystkie dostpne
w danej kategorii usugi.

Rysunek 2.1. Strona XML Web Service suy

do odnajdywania istniejcych usug Web Service,
a take do rejestrowania nowych usug,
aby inni uytkownicy mogli z nich korzysta

5. Kliknij przycisk Go.

Zostanie wywietlona lista dostpnych

serwisw Web Services wraz z ich opisami.
Wskazwki

Wicej informacji o stronie startowej

rodowiska Visual Studio znajduje si

w rozdziale 1.

Aby uzyska dostp do wikszej iloci

opcji, ktre kontroluj szukanie usug,

kliknij przycisk Advanced.

Aby zarejestrowa wasn usug

Web Service za pomoc UDDI,

wybierz zakadk Register a Service,
a nastpnie kliknij odnonik Register
Your XML Web Service Today.

Innym sposobem wyszukania usugi

Web Service jest uycie Internet Explorera

i odwoanie si do strony http://uddi.
microsoft.com/visualstudio (rysunek 2.2)

46

Rysunek 2.2. Strona http://uddi.microsoft.com/

visualstudio umoliwiajca wyszukanie usug
Web Service

Tworzenie usug Web Service

Tworzenie usugi Web Service

Przy uyciu jzyka Visual Basic .NET
niezwykle atwo utworzy usug Web Service,
wic zacznijmy od razu.
W rozdziale 1. zostao opisane, e programy
opieraj si na projektach VB .NET. Tak wic
rodzaj tworzonego programu zaley cakowicie
od rodzaju projektu, ktry wybierzesz spord:
Windows Application, ASP.NET Web
Application, ASP.NET Web Service oraz innych.
Rysunek 2.3. Aby utworzy nowy projekt Web
Service, wybierz opcj ASP.NET Web Service
z panelu Templates

Aby rozpocz tworzenie usugi Web Service,

naley utworzy nowy projekt ASP.NET Web
Service.

1. Otwrz okno dialogowe New Project

(rysunek 2.3). Moesz to zrobi wybierajc

opcj New Project z menu File lub klikajc
przycisk New Project na stronie startowej.
2. Wybierz opcj Visual Basic Projects

z panelu Project Types.

3. Wybierz jako typ projektu ASP.NET Web

Service z panelu Templates.

4. W polu tekstowym Location, po adresie

URL http://localhost/, wpisz nazw projektu.

5. Kliknij przycisk OK.

Zostanie utworzony nowy projekt ASP.NET

Web Service.

47

Tworzenie usugi Web Service

Aby utworzy nowy projekt

ASP.NET Web Service:

Rozdzia 2.
Wskazwki

Adres URL (ang. Uniform Resource Locator)

zosta uzupeniony w czwartym kroku

powyszego zadania przy zaoeniu,
e uruchamiasz i testujesz usugi Web Service
na lokalnym serwerze IIS (ang. Internet
Information Services). Jeli korzystasz
z odlegego komputera macierzystego,
wpisz odpowiedni adres URL w polu
tekstowym Location.

Jeli w trakcie tworzenia projektu pojawi

Tworzenie usugi Web Service

si komunikaty o bdzie, moesz znale

rozwizania problemw w ramce Komunikaty
o bdach: tworzenie aplikacji sieciowych,
ktra znajduje si w rozdziale 1.

Rysunek 2.4. W oknie Solution Explorer mona

zauway modu usugi Web Service o rozszerzeniu
.asmx

Chocia pole tekstowe Name jest nieaktywne,

to tekst, ktry wpiszesz w polu tekstowym

Location jako uzupenienie adresu
http://localhost, zostanie przypisany
jako nazwa projektu i pojawi si w polu
tekstowym Name.

Domylnie http://localhost wskazuje

na katalog Inetpub/wwwroot. Tak wic

przykadowy projekt o nazwie 02VBVQS01
zostanie umieszczony w katalogu Inetpub/
wwwroot/02VBVQS01. Moesz jednak uy
panelu administracyjnego Internet Information
Services, aby umieci projekt w innym
miejscu i utworzy wirtualny adres URL.
Aby uzyska dostp do panelu administracyjnego
IIS, naley otworzy grup Narzdzia
administracyjne (Administrative Tools)
w Panelu sterowania (Control Panel)
komputera.
Otwrz teraz okno Solution Explorer (rysunek 2.4)
i sprawd, jakie pliki zostay dodane do
utworzonego projektu. Zauwa, e wrd
plikw znajduje si modu Web Service,
z domyln nazw Service1.asmx. Informacje
o tym, jak otworzy okno Solution Explorer,
znajduj si w rozdziale 1., w czci zatytuowanej
Aby otworzy okno Solution Explorer.

48

Rysunek 2.5. Projektant klasy Web Service

moe suy do dodawania komponentw
w trybie graficznym

Tworzenie usug Web Service

Po utworzeniu nowego projektu powinien si
w nim otworzy modu Web Service. Dzieje
si tak, o ile nie zostan zmienione domylne
ustawienia. Jeli projekt nie jest otwarty,
wystarczy dwukrotnie klikn jego nazw
w oknie Solution Explorer.

Aby otworzy edytor kodu:

1. W oknie Solution Explorer wybierz

modu Web Service, a nastpnie opcj

Code z menu View.
lub
Kliknij odnonik Switch to Code View
w projektancie Web Service.
Kiedy analizuje si modu Web Service
w edytorze kodu (rysunek 2.6), mona
zauway, e program rozpoczyna si
od instrukcji
:

Tworzenie usugi Web Service

Projektant usug Web Service moe suy

do dodawania komponentw do moduu klasy
w trybie graficznym (rysunek 2.5). O ile
projektowanie formularzy Windows w trybie
graficznym jest sensowne, a wikszo
formularzy Web posiada istotne elementy
graficzne, o tyle projektowanie moduw Web
Service w ten sposb przewanie nie jest zasadne.
Dzieje si tak, poniewa usugi Web Service
skadaj si z samego kodu w postaci metod
(lub funkcji). Uywanie narzdzi, ktre
umoliwiaj projektowanie graficzne, nie daje
adnych korzyci. Wicej informacji o uywaniu
projektantw do przyspieszenia procesu tworzenia
aplikacji Windows i Web znajduje si w rozdziale 5.
Formularze Windows oraz w rozdziale 16.
Aplikacje internetowe ASP.NET.

Kiedy nowy projekt ASP.NET Web Service

jest ju otwarty, naley otworzy edytor kodu,
aby zapozna si ze szczegami moduu
Web Service.


  

Rysunek 2.6. W edytorze kodu mona zauway oznaczon jako komentarz metod
(WebMethod) HelloWorld

49

Rozdzia 2.
Instrukcja ta przesya do kompilatora informacj,
e w kodzie mog by uywane klasy
oraz elementy klas z przestrzeni nazw

 
.
Nastpnie umieszczone s linie kodu, ktre
w rzeczywistoci stanowi czci jednej instrukcji:
  

 !"! #

$
    

Tworzenie usugi Web Service

Pierwsza cz instrukcji, znacznik ,

informuje rodowisko Visual Basic, e kod
stanowi usug Web Service.
W dalszej czci instrukcji znajduje si nazwa
klasy () oraz okrelenie klasy, z ktrej
dziedziczy (
 

).
Wicej informacji o dziedziczeniu klas zawiera
rozdzia 3. Praca z klasami.
Wskazwka

W nastpnej linii edytora kodu znajduje si
szary znak  (plus), po ktrym mona
zobaczy napis 


. Po klikniciu tego znaku

kod, ktry zosta utworzony automatycznie

przez projektanta, rozwinie si i bdzie
widoczny. Kod ten uatwia rozmieszczenie
komponentw w projektancie usug Web
Service.
W dalszej czci kodu znajduje si przykadowa
usuga Web Service: metoda o nazwie
  ,
ktra zwraca acuch tekstowy !
  !.
Na rysunku 2.6 fragment ten jest oznaczony
jako komentarz za pomoc pojedynczych
apostrofw ("). Po usuniciu symboli
komentarza dostpny jest szkielet metody
umieszczony w usudze Web Service.
Kod koczy si instrukcj:



Kiedy wiadomo ju, co znajduje si w module

Web Service w konfiguracji standardowej,
mona przystpi do pracy nad wasn usug.
Na pocztek zmie domylny adres URI.

50

Adres Uniform
Resource Identifier
Domylnie kada nowa usuga Web
Service w rodowisku Visual Studio
posiada atrybut Namespace w postaci
http://tempuri.org. Jest to adres URI
(ang. Uniform Resource Identifier),
ktry powinien wskazywa na lokalizacj
bdc pod kontrol programisty.
W przeciwiestwie do adresu URL,
uytkownik nie musi mie moliwoci
dostania si do tej lokalizacji.
Jeli pozostawisz domylny adres URI,
kade uruchomienie strony testowej
usugi Web Service spowoduje, e
wywietli si propozycja zmiany adresu.

Tworzenie usug Web Service

Aby zmieni domylny adres URI:

1. Przypisz adresowi URI w znaczniku
 now warto:
  
%
 !"! #

$
    

Nastpnie dodaj metod Web do usugi.

Aby doda metod Web do usugi:

1. Dodaj znacznik atrybutu #$.

Funkcja oznaczona tym znacznikiem bdzie

metod Web.
2. Utwrz funkcj.

Na listingu 2.1 pokazany jest cay kod usugi

Web Service wraz z now metod Web,
ktra zwraca acuch znakw.
Wskazwka

Instrukcja
&!!'( '!)*+,-

przypisuje acuch znakw !%

& '

()

&*+! do funkcji, ktra staje si
wartoci zwracan przez metod Web.
Listing 2.1. Usuga Web Service z metod, ktra zwraca acuch znakw

 
  
  
%
 #
  
    
 ./&!!'(  
&!!'( '!)*+,-





51

Tworzenie usugi Web Service

Funkcja ta jest metod Web.

Rozdzia 2.

Testowanie usug Web Service

Mona atwo testowa usugi Web Service,
jak te zwizane z nimi metody, za pomoc
rodowiska Visual Studio, ktre tworzy strony
testowe.

Aby przetestowa usug

Web Service i jej metody:
1. Uruchom projekt poprzez wybranie opcji Start

z menu Debug lub kliknicie strzaki Start.

Powinna otworzy si strona testowa
(rysunek 2.7).

Rysunek 2.7. Strona testowa, wygenerowana dla

usugi Web Service przez rodowisko Visual Studio,
zawiera odnoniki do metod, ktre ta usuga
udostpnia

Testowanie usug Web Service

2. Kliknij odnonik metody Web, ktry

znajduje si na stronie testowej usugi.

Otworzy si strona testowa dla konkretnej
metody Web (rysunek 2.8).
3. Kliknij przycisk Invoke.

Program zwrci stron w formacie XML,

na ktrej znajduje si warto zwracana
przez metod Web oraz typ danych
w tym przypadku acuch znakw

 (rysunek 2.9).

Rysunek 2.8. Aby przetestowa metod Web,

kliknij przycisk Invoke

Rysunek 2.9. Warto zwracana przez metod Web wywietlana jest w formacie XML

52

Tworzenie usug Web Service

Dodawanie metod Web

Usuga Web Service moe zawiera wiele metod
Web. eby robi co naprawd poytecznego,
metoda powinna wykonywa co wicej, ni
tylko zwracanie acucha znakw. Stworzysz
teraz metod Web, ktra moe przyjmowa
rne dane wejciowe. Zacznij od dodania
metody Web, ktra oblicza sum dwch liczb
cakowitych typu .

Aby doda metod Web,

ktra sumuje dwie liczby cakowite:
1. Dodaj znacznik atrybutu #$.

Funkcja oznaczona tym znacznikiem

bdzie metod Web.
ktra bdzie przyjmowa jako argumenty
dwie liczby cakowite typu . Zwracan
wartoci bdzie liczba tego samego typu.
3. Przypisz wynik dodawania do funkcji,

jak przedstawiono to na listingu 2.2.

Wskazwka

Przedstawiony kod nie sprawdza, czy

uytkownik rzeczywicie wpisa liczby

cakowite. Jeli uytkownik wprowadzi
na stronie testowej tekst zamiast liczby,
to program zgosi wyjtek. W rozdziale 6.
Uywanie usug Web Service znajduje
si przykad, jak sprawdza poprawno
wprowadzanych przez uytkownika danych.
Aby zrozumie, jak dziaaj wyjtki,
naley zapozna si z rozdziaem 9.
Wyjtki i usuwanie bdw.
Listing 2.2. Metoda, ktra dodaje dwie liczby cakowite typu long
 ./0//+%$1$2
$+%
0//+%$1$3$+%



53

Dodawanie metod Web

2. Utwrz funkcj o nazwie ,-(&

,

Rozdzia 2.

Testowanie metody Web

Now metod Web mona atwo testowa.
Wystarczy uruchomi usug, ktra zawiera t
metod.

Aby przetestowa metod,

ktra dodaje dwie liczby:
1. Uruchom projekt poprzez wybranie opcji Start

z menu Debug lub kliknicie strzaki Start.

Otworzy si strona testowa usugi, na ktrej
wida obie metody Web (rysunek 2.10).

Rysunek 2.10. Nowa metoda Web pojawia si

w postaci odnonika na stronie testowej usugi
Web Service

2. Na stronie testowej kliknij odnonik

Testowanie metody Web

do metody o nazwie AddTwoNums.

Otworzy si strona testowa metody
AddTwoNums, na ktrej znajduj si miejsca,
gdzie uytkownik moe wpisa wartoci
argumentw przyjmowanych przez t metod
(rysunek 2.11).
3. Wpisz wartoci dla argumentw &  oraz
& -, a nastpnie kliknij przycisk Invoke.

Program wywietli stron w formacie XML.

Na stronie tej powinna znale si warto
zwracana przez metod (suma dwch
wpisanych liczb) oraz typ danych ( )
(rysunek 2.12).

Rysunek 2.11. Strona testowa udostpnia pole

do wpisywania argumentw przez uytkownika

Podsumowanie
W rozdziale nauczye si:
u opisywa usugi Web Service, a take

zwizane z nimi standardy, takie jak SOAP,

WSDL i UDDI;
u tworzy projekt usugi Web Service;
u pracowa z moduem Web Service

w edytorze kodu;
u dodawa metod do usugi Web Service;
u testowa usugi i metody za pomoc

strony testowej rodowiska Visual Studio;

u dodawa i testowa metod Web,

ktra przyjmuje dane wprowadzane

przez uytkownika.
54

Rysunek 2.12. Wynik dziaania metody Web

na argumentach, ktre wprowadzi uytkownik,
wywietla si w formacie XML