WebClient.UploadString Метод

Ссылка

Определение

Пространство имен:: System.Net

Сборка:: System.Net.WebClient.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Отправляет указанную строку в указанный ресурс.

Перегрузки

UploadString(String, String)	Отправляет указанную строку в указанный ресурс с помощью метода POST.
UploadString(Uri, String)	Отправляет указанную строку в указанный ресурс с помощью метода POST.
UploadString(String, String, String)	Отправляет указанную строку в указанный ресурс с помощью указанного метода.
UploadString(Uri, String, String)	Отправляет указанную строку в указанный ресурс с помощью указанного метода.

UploadString(String, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанную строку в указанный ресурс с помощью метода POST.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ data);

public string UploadString (string address, string data);

member this.UploadString : string * string -> string

Public Function UploadString (address As String, data As String) As String

Параметры

address: String

URI ресурса для получения строки. Для ресурсов Http этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.

data: String

Строка для отправки.

Возвращаемое значение

String

String, содержащий ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

Примеры

В следующем примере кода показано, как вызвать этот метод.

void UploadString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   WebClient^ client = gcnew WebClient;

   // Optionally specify an encoding for uploading and downloading strings.
   client->Encoding = System::Text::Encoding::UTF8;

   // Upload the data.
   String^ reply = client->UploadString( address, data );

   // Disply the server's response.
   Console::WriteLine( reply );
}

public static void UploadString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    WebClient client = new WebClient();
    // Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8;
    // Upload the data.
    string reply = client.UploadString(address, data);
    // Display the server's response.
    Console.WriteLine(reply);
}

Public Shared Sub UploadString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim client As WebClient = New WebClient()
    '  Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8
    '  Upload the data.
    Dim reply As String = client.UploadString(address, data)
    '  Disply the server's response.
    Console.WriteLine(reply)
End Sub

Перед отправкой строки этот метод преобразует его в массив Byte с помощью кодировки, указанной в свойстве Encoding. Этот метод блокирует передачу строки. Чтобы отправить строку и продолжить выполнение во время ожидания ответа сервера, используйте один из методов UploadStringAsync.

Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.

Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.

Применяется к

UploadString(Uri, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанную строку в указанный ресурс с помощью метода POST.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ data);

public string UploadString (Uri address, string data);

member this.UploadString : Uri * string -> string

Public Function UploadString (address As Uri, data As String) As String

Параметры

address: Uri

data: String

Строка для отправки.

Возвращаемое значение

String

String, содержащий ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

Применяется к

UploadString(String, String, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанную строку в указанный ресурс с помощью указанного метода.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);

public string UploadString (string address, string? method, string data);

public string UploadString (string address, string method, string data);

member this.UploadString : string * string * string -> string

Public Function UploadString (address As String, method As String, data As String) As String

Параметры

address: String

URI ресурса для получения строки. Этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода method.

method: String

Метод HTTP, используемый для отправки строки в ресурс. Если значение NULL, значение по умолчанию — POST для http и STOR для ftp.

data: String

Строка для отправки.

Возвращаемое значение

String

String, содержащий ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

method нельзя использовать для отправки содержимого.

Примеры

В следующем примере кода показано, как вызвать этот метод.

void PostString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   String^ method = "POST";
   WebClient^ client = gcnew WebClient;
   String^ reply = client->UploadString( address, method, data );
   Console::WriteLine( reply );
}

public static void PostString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    string method = "POST";
    WebClient client = new WebClient();
    string reply = client.UploadString(address, method, data);

    Console.WriteLine(reply);
}

Public Shared Sub PostString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim method As String = "POST"
    Dim client As WebClient = New WebClient()
    Dim reply As String = client.UploadString(address, method, data)

    Console.WriteLine(reply)
End Sub

Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.

Заметка

Применяется к

UploadString(Uri, String, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанную строку в указанный ресурс с помощью указанного метода.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);

public string UploadString (Uri address, string? method, string data);

public string UploadString (Uri address, string method, string data);

member this.UploadString : Uri * string * string -> string

Public Function UploadString (address As Uri, method As String, data As String) As String

Параметры

address: Uri

method: String

data: String

Строка для отправки.

Возвращаемое значение

String

String, содержащий ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

method нельзя использовать для отправки содержимого.

Применяется к

Поделиться через

WebClient.UploadString Метод

Определение

Перегрузки

UploadString(String, String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

UploadString(Uri, String)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

UploadString(String, String, String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

UploadString(Uri, String, String)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

Дополнительные ресурсы