WebClient.OpenWrite Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net

Bütünleştirilmiş Kod:: System.Net.WebClient.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen URI'ye sahip bir kaynağa veri yazmak için bir akış açar.

Aşırı Yüklemeler

OpenWrite(String)	Belirtilen kaynağa veri yazmak için bir akış açar.
OpenWrite(Uri)	Belirtilen kaynağa veri yazmak için bir akış açar.
OpenWrite(String, String)	Belirtilen yöntemi kullanarak belirtilen kaynağa veri yazmak için bir akış açar.
OpenWrite(Uri, String)	Belirtilen yöntemi kullanarak belirtilen kaynağa veri yazmak için bir akış açar.

OpenWrite(String)

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Belirtilen kaynağa veri yazmak için bir akış açar.

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

Parametreler

address: String

Verileri alacak kaynağın URI'si.

Döndürülenler

Stream

Kaynağa veri yazmak için kullanılan bir Stream.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

BaseAddressve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Akış açılırken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, komut satırından verileri okur ve verileri yazmak için bir akış elde etmek için OpenWrite kullanır. OpenWrite tarafından döndürülen Stream, veriler gönderildikten sonra kapatılır.

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

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

OpenWrite yöntemi, bir kaynağa veri göndermek için kullanılan yazılabilir bir akış döndürür. Bu yöntem akışı açarken engeller. Akışı beklerken yürütmeye devam etmek için OpenWriteAsync yöntemlerinden birini kullanın.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Bu yöntem bir FTP kaynağını karşıya yüklemek için STOR komutunu kullanır. BIR HTTP kaynağı için POST yöntemi kullanılır.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

OpenWrite(Uri)

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Belirtilen kaynağa veri yazmak için bir akış açar.

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

Parametreler

address: Uri

Verileri alacak kaynağın URI'si.

Döndürülenler

Stream

Kaynağa veri yazmak için kullanılan bir Stream.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

BaseAddressve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Akış açılırken bir hata oluştu.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Bu yöntem bir FTP kaynağını karşıya yüklemek için STOR komutunu kullanır. BIR HTTP kaynağı için POST yöntemi kullanılır.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

OpenWrite(String, String)

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Belirtilen yöntemi kullanarak belirtilen kaynağa veri yazmak için bir akış açar.

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

public System.IO.Stream OpenWrite (string address, 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

Parametreler

address: String

Verileri alacak kaynağın URI'si.

method: String

Verileri kaynağa göndermek için kullanılan yöntem. Null ise, varsayılan değer http için POST ve ftp için STOR'dır.

Döndürülenler

Stream

Kaynağa veri yazmak için kullanılan bir Stream.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

BaseAddressve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Akış açılırken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, komut satırından verileri okur ve verileri yazmak için kullanılan bir akış elde etmek için OpenWrite kullanır. verileri göndermek için OpenWrite tarafından döndürülen Stream kapatılmalıdır.

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

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

OpenWrite yöntemi, bir kaynağa veri göndermek için kullanılan yazılabilir bir akış döndürür. Temel istek, method parametresinde belirtilen yöntemle yapılır. Akışı kapattığınızda veriler sunucuya gönderilir. Bu yöntem akışı açarken engeller. Akışı beklerken yürütmeye devam etmek için OpenWriteAsync yöntemlerinden birini kullanın.

method parametresi sunucu tarafından anlaşılmayan bir yöntem belirtirse, ne olduğunu temel protokol sınıfları belirler. Genellikle, hatayı belirtmek için Status özelliği ayarlanmış bir WebException oluşturulur.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak adres belirtmiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

OpenWrite(Uri, String)

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Kaynak:: WebClient.cs

Belirtilen yöntemi kullanarak belirtilen kaynağa veri yazmak için bir akış açar.

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

public System.IO.Stream OpenWrite (Uri address, 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

Parametreler

address: Uri

Verileri alacak kaynağın URI'si.

method: String

Verileri kaynağa göndermek için kullanılan yöntem. Null ise, varsayılan değer http için POST ve ftp için STOR'dır.

Döndürülenler

Stream

Kaynağa veri yazmak için kullanılan bir Stream.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

BaseAddressve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Akış açılırken bir hata oluştu.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Aracılığıyla paylaş

WebClient.OpenWrite Yöntem

Tanım

Aşırı Yüklemeler

OpenWrite(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

OpenWrite(Uri)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

OpenWrite(String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

OpenWrite(Uri, String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar