WebClient.OpenWrite Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Membuka aliran untuk menulis data ke sumber daya dengan URI yang ditentukan.

Overload

OpenWrite(String)	Membuka aliran untuk menulis data ke sumber daya yang ditentukan.
OpenWrite(Uri)	Membuka aliran untuk menulis data ke sumber daya yang ditentukan.
OpenWrite(String, String)	Membuka aliran untuk menulis data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.
OpenWrite(Uri, String)	Membuka aliran untuk menulis data ke sumber daya yang ditentukan, dengan menggunakan metode yang ditentukan.

OpenWrite(String)

Sumber:

WebClient.cs

Membuka aliran untuk menulis data ke sumber daya yang ditentukan.

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

Parameter

address

String

URI sumber daya untuk menerima data.

Mengembalikan

Stream

Digunakan Stream untuk menulis data ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

Contoh

Contoh kode berikut membaca data dari baris perintah dan menggunakan OpenWrite untuk mendapatkan aliran untuk menulis data. yang Stream dikembalikan oleh OpenWrite ditutup setelah data dikirim.

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.")

Keterangan

Metode mengembalikan OpenWrite aliran bisa-tulis yang digunakan untuk mengirim data ke sumber daya. Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi sambil menunggu aliran, gunakan salah OpenWriteAsync satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

OpenWrite(Uri)

Sumber:

WebClient.cs

Membuka aliran untuk menulis data ke sumber daya yang ditentukan.

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

Parameter

address

Uri

URI sumber daya untuk menerima data.

Mengembalikan

Stream

Digunakan Stream untuk menulis data ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

Keterangan

Metode mengembalikan OpenWrite aliran bisa-tulis yang digunakan untuk mengirim data ke sumber daya. Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi sambil menunggu aliran, gunakan salah OpenWriteAsync satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

OpenWrite(String, String)

Sumber:

WebClient.cs

Membuka aliran untuk menulis data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

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

Parameter

address

String

URI sumber daya untuk menerima data.

method

String

Metode yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

Mengembalikan

Stream

Digunakan Stream untuk menulis data ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

Contoh

Contoh kode berikut membaca data dari baris perintah dan menggunakan OpenWrite untuk mendapatkan aliran yang digunakan untuk menulis data. yang Stream dikembalikan oleh OpenWrite harus ditutup untuk mengirim 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 .
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.")

Keterangan

Metode mengembalikan OpenWrite aliran bisa-tulis yang digunakan untuk mengirim data ke sumber daya. Permintaan yang mendasar dibuat dengan metode yang ditentukan dalam method parameter . Data dikirim ke server saat Anda menutup aliran. Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi sambil menunggu aliran, gunakan salah OpenWriteAsync satu metode .

method Jika parameter menentukan metode yang tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang Status diatur untuk menunjukkan kesalahan.

BaseAddress Jika properti bukan string kosong ("") dan address tidak menentukan alamat absolut, address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

OpenWrite(Uri, String)

Sumber:

WebClient.cs

Membuka aliran untuk menulis data ke sumber daya yang ditentukan, dengan menggunakan metode yang ditentukan.

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

Parameter

address

Uri

URI sumber daya untuk menerima data.

method

String

Metode yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

Mengembalikan

Stream

Digunakan Stream untuk menulis data ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

Keterangan

Metode mengembalikan OpenWrite aliran bisa-tulis yang digunakan untuk mengirim data ke sumber daya. Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi sambil menunggu aliran, gunakan salah OpenWriteAsync satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.