WebClient.UploadData Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Belirtilen URI'ye sahip bir kaynağa veri arabelleği yükler.

Aşırı Yüklemeler

UploadData(String, Byte[])	URI tarafından tanımlanan bir kaynağa veri arabelleği yükler.
UploadData(Uri, Byte[])	URI tarafından tanımlanan bir kaynağa veri arabelleği yükler.
UploadData(String, String, Byte[])	Belirtilen yöntemi kullanarak belirtilen kaynağa bir veri arabelleği yükler.
UploadData(Uri, String, Byte[])	Belirtilen yöntemi kullanarak belirtilen kaynağa bir veri arabelleği yükler.

UploadData(String, Byte[])

Kaynak:

WebClient.cs

URI tarafından tanımlanan bir kaynağa veri arabelleği yükler.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, cli::array <System::Byte> ^ data);

public byte[] UploadData (string address, byte[] data);

member this.UploadData : string * byte[] -> byte[]

Public Function UploadData (address As String, data As Byte()) As Byte()

Parametreler

address

String

Verileri alacak kaynağın URI'si.

data

Byte[]

Kaynağa gönderilecek veri arabelleği.

Döndürülenler

Byte[]

Kaynaktan gelen yanıtın gövdesini içeren bir Byte dizisi.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

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

-veya-

data null.

-veya-

Veriler gönderilirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

Örnekler

Aşağıdaki kod örneği, konsolundan girilen bir dizeyi Byte dizisine dönüştürür ve UploadDatakullanarak diziyi belirtilen sunucuya gönderir. Sunucudan gelen tüm yanıtlar konsola görüntülenir.

Console::Write( "\nPlease enter the URI to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII Encoding to obtain the String* as a Byte array.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

//UploadData implicitly sets HTTP POST as the request method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, postArray );

// Decode and display the response.
Console::WriteLine( "\nResponse received was: {0}", Encoding::ASCII->GetString( responseArray ) );

    Console.Write("\nPlease enter the URI to post data to : ");
    string uriString = Console.ReadLine();
    // Create a new WebClient instance.
    WebClient myWebClient = new WebClient();
    Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
    string postData = Console.ReadLine();
    // Apply ASCII Encoding to obtain the string as a byte array.
    byte[] postArray = Encoding.ASCII.GetBytes(postData);
    Console.WriteLine("Uploading to {0} ...",  uriString);							
 myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

    //UploadData implicitly sets HTTP POST as the request method.
    byte[] responseArray = myWebClient.UploadData(uriString,postArray);

    // Decode and display the response.
    Console.WriteLine("\nResponse received was :{0}", Encoding.ASCII.GetString(responseArray));

Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
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 the string as a byte array.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' UploadData implicitly sets HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, postArray)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

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.

UploadData yöntemi kaynağa veri arabelleği gönderir.

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. Temel alınan istek sunucu tarafından anlaşılmıyorsa, ne olduğunu temel protokol sınıfları belirler. Genellikle, hatayı belirtmek için Status özelliği ayarlanmış bir WebException oluşturulur.

UploadData yöntemi, data içeriğini kodlamadan sunucuya gönderir. Bu yöntem verileri karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için UploadDataAsync 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.

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.

UploadData(Uri, Byte[])

Kaynak:

WebClient.cs

URI tarafından tanımlanan bir kaynağa veri arabelleği yükler.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, cli::array <System::Byte> ^ data);

public byte[] UploadData (Uri address, byte[] data);

member this.UploadData : Uri * byte[] -> byte[]

Public Function UploadData (address As Uri, data As Byte()) As Byte()

Parametreler

address

Uri

Verileri alacak kaynağın URI'si.

data

Byte[]

Kaynağa gönderilecek veri arabelleği.

Döndürülenler

Byte[]

Kaynaktan gelen yanıtın gövdesini içeren bir Byte dizisi.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

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

-veya-

data null.

-veya-

Veriler gönderilirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

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.

UploadData yöntemi kaynağa veri arabelleği gönderir.

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. Temel alınan istek sunucu tarafından anlaşılmıyorsa, ne olduğunu temel protokol sınıfları belirler. Genellikle, hatayı belirtmek için Status özelliği ayarlanmış bir WebException oluşturulur.

UploadData yöntemi, data içeriğini kodlamadan sunucuya gönderir. Bu yöntem verileri karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için UploadDataAsync 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.

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.

UploadData(String, String, Byte[])

Kaynak:

WebClient.cs

Belirtilen yöntemi kullanarak belirtilen kaynağa bir veri arabelleği yükler.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public byte[] UploadData (string address, string? method, byte[] data);

member this.UploadData : string * string * byte[] -> byte[]

Public Function UploadData (address As String, method As String, data As Byte()) As Byte()

Parametreler

address

String

Verileri alacak kaynağın URI'si.

method

String

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

data

Byte[]

Kaynağa gönderilecek veri arabelleği.

Döndürülenler

Byte[]

Kaynaktan gelen yanıtın gövdesini içeren bir Byte dizisi.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

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

-veya-

data null.

-veya-

Veriler karşıya yüklenirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

Örnekler

Aşağıdaki kod örneği, konsolundan girilen bir dizeyi bayt dizisine dönüştürür ve UploadDatakullanarak diziyi belirtilen sunucuya gönderir. Sunucudan gelen tüm yanıtlar konsola görüntülenir.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to {for example, http://www.contoso.com}: " );
uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

// Displays the headers in the request
Console::Write( "Resulting Request Headers: ");
Console::WriteLine(myWebClient->Headers);

// Apply ASCII Encoding to obtain the String^ as a Byte array.
array<Byte>^ byteArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
// Upload the input String* using the HTTP 1.0 POST method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, "POST", byteArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was {0}",
   Encoding::ASCII->GetString( responseArray ) );

   string uriString;
       Console.Write("\nPlease enter the URI to post data to {for example, http://www.contoso.com} : ");
       uriString = Console.ReadLine();

       // Create a new WebClient instance.
       WebClient myWebClient = new WebClient();
       Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
       string postData = Console.ReadLine();
       myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

 // Display the headers in the request
       Console.Write("Resulting Request Headers: ");
       Console.WriteLine(myWebClient.Headers.ToString());
       
       // Apply ASCII Encoding to obtain the string as a byte array.

       byte[] byteArray = Encoding.ASCII.GetBytes(postData);
       Console.WriteLine("Uploading to {0} ...",  uriString);						
       // Upload the input string using the HTTP 1.0 POST method.
       byte[] responseArray = myWebClient.UploadData(uriString,"POST",byteArray);
       
       // Decode and display the response.
       Console.WriteLine("\nResponse received was {0}",
       Encoding.ASCII.GetString(responseArray));
                 

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to{for example, http://www.contoso.com} : ")
uriString = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' Display the headers in the request
Console.Write("Resulting Request Headers: ")
Console.Writeline(myWebClient.Headers.ToString())

' Apply ASCII Encoding to obtain the string as a byte array.
Dim byteArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
' Upload the input string using the HTTP 1.0 POST method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, "POST", byteArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

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.

UploadData yöntemi, method parametresinde belirtilen HTTP yöntemini kullanarak bir kaynağa veri arabelleği gönderir ve sunucudan gelen tüm yanıtları döndürür. Bu yöntem verileri karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için UploadDataAsync yöntemlerinden birini kullanın.

UploadData yöntemi, data içeriğini kodlamadan sunucuya gönderir.

method parametresi sunucu tarafından anlaşılmayan bir fiil 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 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.

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.

UploadData(Uri, String, Byte[])

Kaynak:

WebClient.cs

Belirtilen yöntemi kullanarak belirtilen kaynağa bir veri arabelleği yükler.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public byte[] UploadData (Uri address, string? method, byte[] data);

member this.UploadData : Uri * string * byte[] -> byte[]

Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()

Parametreler

address

Uri

Verileri alacak kaynağın URI'si.

method

String

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

data

Byte[]

Kaynağa gönderilecek veri arabelleği.

Döndürülenler

Byte[]

Kaynaktan gelen yanıtın gövdesini içeren bir Byte dizisi.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

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

-veya-

data null.

-veya-

Veriler karşıya yüklenirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

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.

UploadData yöntemi, method parametresinde belirtilen HTTP yöntemini kullanarak bir kaynağa veri arabelleği gönderir ve sunucudan gelen tüm yanıtları döndürür. Bu yöntem verileri karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için UploadDataAsync yöntemlerinden birini kullanın.

UploadData yöntemi, data içeriğini kodlamadan sunucuya gönderir.

method parametresi sunucu tarafından anlaşılmayan bir fiil 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 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.

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.