WebClient.OpenWrite Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

Открывает поток для записи данных в ресурс с заданным URI.

Перегрузки

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

OpenWrite(String)

Исходный код:

WebClient.cs

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

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address);

public System.IO.Stream OpenWrite (string address);

member this.OpenWrite : string -> System.IO.Stream

Public Function OpenWrite (address As String) As Stream

Параметры

address

String

URI ресурса, которому передаются данные.

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

Stream

Stream, используемый для записи данных в ресурс.

Исключения

ArgumentNullException

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

WebException

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

-или-

При открытии потока произошла ошибка.

Примеры

В следующем примере кода считываются данные из командной строки и используется OpenWrite для получения потока для записи данных. Объект , Stream возвращаемый методом OpenWrite , закрывается после отправки данных.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply Ascii Encoding to obtain an array of bytes.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

// postStream implicitly sets HTTP POST as the request method.
Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString );

postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();

Console::WriteLine( "\nSuccessfully posted the data." );

string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply Ascii Encoding to obtain an array of bytes. 
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

// postStream implicitly sets HTTP POST as the request method.
Console.WriteLine("Uploading to {0} ...",  uriString);							Stream postStream = myWebClient.OpenWrite(uriString);

postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();

Console.WriteLine("\nSuccessfully posted the data.");

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)

Dim postData As String = Console.ReadLine()

' Apply ASCII Encoding to obtain an array of bytes .
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)

' OpenWrite implicitly sets HTTP POST as the request method.
Dim postStream As Stream = myWebClient.OpenWrite(uriString)
postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

Комментарии

Метод OpenWrite возвращает доступный для записи поток, который используется для отправки данных в ресурс. Этот метод блокирует при открытии потока. Чтобы продолжить выполнение во время ожидания потока, используйте один из OpenWriteAsync методов .

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

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

Примечание

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

OpenWrite(Uri)

Исходный код:

WebClient.cs

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

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address);

public System.IO.Stream OpenWrite (Uri address);

member this.OpenWrite : Uri -> System.IO.Stream

Public Function OpenWrite (address As Uri) As Stream

Параметры

address

Uri

URI ресурса, которому передаются данные.

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

Stream

Stream, используемый для записи данных в ресурс.

Исключения

ArgumentNullException

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

WebException

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

-или-

При открытии потока произошла ошибка.

Комментарии

Метод OpenWrite возвращает доступный для записи поток, который используется для отправки данных в ресурс. Этот метод блокирует при открытии потока. Чтобы продолжить выполнение во время ожидания потока, используйте один из OpenWriteAsync методов .

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

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

Примечание

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

OpenWrite(String, String)

Исходный код:

WebClient.cs

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

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address, System::String ^ method);

public System.IO.Stream OpenWrite (string address, string? method);

member this.OpenWrite : string * string -> System.IO.Stream

Public Function OpenWrite (address As String, method As String) As Stream

Параметры

address

String

URI ресурса, которому передаются данные.

method

String

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

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

Stream

Stream, используемый для записи данных в ресурс.

Исключения

ArgumentNullException

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

WebException

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

-или-

При открытии потока произошла ошибка.

Примеры

Следующий пример кода считывает данные из командной строки и использует OpenWrite для получения потока, используемого для записи данных. Для Stream отправки данных необходимо закрыть объект , возвращаемый методом OpenWrite .

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString, "POST" );
postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();
Console::WriteLine( "\nSuccessfully posted the data." );

string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("Uploading to {0} ...",  uriString);						
Stream postStream = myWebClient.OpenWrite(uriString,"POST");
postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();
Console.WriteLine("\nSuccessfully posted the data.");

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII encoding to obtain an array of bytes.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)
Dim postStream As Stream = myWebClient.OpenWrite(uriString, "POST")

postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

Комментарии

Метод OpenWrite возвращает доступный для записи поток, который используется для отправки данных в ресурс. Базовый запрос выполняется с помощью метода, указанного в параметре method . Данные отправляются на сервер при закрытии потока. Этот метод блокирует при открытии потока. Чтобы продолжить выполнение во время ожидания потока, используйте один из OpenWriteAsync методов .

method Если параметр задает метод, который не распознается сервером, базовые классы протоколов определяют, что происходит. Как правило, возникает исключение со свойством , WebException заданным Status для указания ошибки.

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

Примечание

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

OpenWrite(Uri, String)

Исходный код:

WebClient.cs

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

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address, System::String ^ method);

public System.IO.Stream OpenWrite (Uri address, string? method);

member this.OpenWrite : Uri * string -> System.IO.Stream

Public Function OpenWrite (address As Uri, method As String) As Stream

Параметры

address

Uri

URI ресурса, которому передаются данные.

method

String

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

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

Stream

Stream, используемый для записи данных в ресурс.

Исключения

ArgumentNullException

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

WebException

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

-или-

При открытии потока произошла ошибка.

Комментарии

Метод OpenWrite возвращает доступный для записи поток, который используется для отправки данных в ресурс. Этот метод блокирует при открытии потока. Чтобы продолжить выполнение во время ожидания потока, используйте один из OpenWriteAsync методов .

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

Примечание

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