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

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

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, должен быть относительным URI, address который объединяется с 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

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

data
String

Выгружаемая строка.

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

String

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

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

Комментарии

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

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.

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

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, используемый для передачи строки ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.

data
String

Выгружаемая строка.

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

String

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

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

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

Комментарии

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.

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

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

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

method
String

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

data
String

Выгружаемая строка.

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

String

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

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

Комментарии

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.

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