WebClient.UploadString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выгружает указанную строку в указанный ресурс.
Перегрузки
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, содержащая ответ, отправленный сервером.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
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, содержащая ответ, отправленный сервером.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
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, содержащая ответ, отправленный сервером.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
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, содержащая ответ, отправленный сервером.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Метод method
не может использоваться для отправки содержимого.
Комментарии
Перед отправкой строки этот метод преобразует ее в Byte массив с использованием кодировки, указанной в свойстве Encoding . Этот метод блокирует передачу строки. Чтобы отправить строку и продолжить выполнение в ожидании ответа сервера, используйте один из UploadStringAsync методов.
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, должен быть относительным URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных.
QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по