WebClient.DownloadString Metoda

Definicja

Pobiera żądany zasób jako String. Zasób do pobrania może być określony 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)

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

Identyfikator String zawierający identyfikator URI do pobrania.

Zwraca

String

Element String zawierający żądany zasób.

Wyjątki

Parametr address to null.

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

-lub-

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

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

Ta metoda pobiera określony zasób. Po pobraniu zasobu metoda używa kodowania określonego Encoding we właściwości , 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 DownloadStringAsync metod.

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

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

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy

DownloadString(Uri)

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

Uri Obiekt zawierający identyfikator URI do pobrania.

Zwraca

String

Element String zawierający żądany zasób.

Wyjątki

Parametr address to null.

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

-lub-

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

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

Uwagi

Ta metoda pobiera określony zasób. Po pobraniu zasobu metoda używa kodowania określonego Encoding we właściwości , 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 DownloadStringAsync metod.

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

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

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy