WebClient.DownloadString Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Pobiera żądany zasób jako String. Zasób do pobrania można określić jako String zawierający identyfikator URI lub Uri.

Przeciążenia

DownloadString(String)	Pobiera żądany zasób jako String. Zasób do pobrania jest określony jako String zawierający identyfikator URI.
DownloadString(Uri)	Pobiera żądany zasób jako String. Zasób do pobrania jest określony jako Uri.

DownloadString(String)

Źródło:

WebClient.cs

Pobiera żądany zasób jako String. Zasób do pobrania jest określony jako String zawierający identyfikator URI.

public:
 System::String ^ DownloadString(System::String ^ address);

public string DownloadString (string address);

member this.DownloadString : string -> string

Public Function DownloadString (address As String) As String

Parametry

address

String

String zawierający identyfikator URI do pobrania.

Zwraca

String

String zawierający żądany zasób.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

NotSupportedException

Metoda została wywołana jednocześnie w wielu wątkach.

Przykłady

W poniższym przykładzie kodu pokazano wywołanie tej metody.

void DownloadString( String^ address )
{
   WebClient^ client = gcnew WebClient;
   String^ reply = client->DownloadString( address );
   Console::WriteLine( reply );
}

public static void DownloadString(string address)
{
    WebClient client = new WebClient();
    string reply = client.DownloadString(address);

    Console.WriteLine(reply);
}

Public Shared Sub DownloadString(ByVal address As String)

    Dim client As WebClient = New WebClient()
    Dim reply As String = client.DownloadString(address)

    Console.WriteLine(reply)
End Sub

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta metoda pobiera określony zasób. Po pobraniu zasobu metoda używa kodowania określonego we właściwości Encoding, aby przekonwertować zasób na String. Ta metoda blokuje pobieranie zasobu. Aby pobrać zasób i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod DownloadStringAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

DownloadString(Uri)

Źródło:

WebClient.cs

Pobiera żądany zasób jako String. Zasób do pobrania jest określony jako Uri.

public:
 System::String ^ DownloadString(Uri ^ address);

public string DownloadString (Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String

Parametry

address

Uri

Obiekt Uri zawierający identyfikator URI do pobrania.

Zwraca

String

String zawierający żądany zasób.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

NotSupportedException

Metoda została wywołana jednocześnie w wielu wątkach.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta metoda pobiera określony zasób. Po pobraniu zasobu metoda używa kodowania określonego we właściwości Encoding, aby przekonwertować zasób na String. Ta metoda blokuje pobieranie zasobu. Aby pobrać zasób i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod DownloadStringAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.