WebClient.UploadValues Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Belirtilen URI'ye sahip bir kaynağa bir ad/değer koleksiyonu yükler.

Aşırı Yüklemeler

UploadValues(String, NameValueCollection)	Belirtilen ad/değer koleksiyonunu belirtilen URI tarafından tanımlanan kaynağa yükler.
UploadValues(Uri, NameValueCollection)	Belirtilen ad/değer koleksiyonunu belirtilen URI tarafından tanımlanan kaynağa yükler.
UploadValues(String, String, NameValueCollection)	Belirtilen ad/değer koleksiyonunu belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler.
UploadValues(Uri, String, NameValueCollection)	Belirtilen ad/değer koleksiyonunu belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler.

UploadValues(String, NameValueCollection)

Kaynak:

WebClient.cs

Belirtilen ad/değer koleksiyonunu belirtilen URI tarafından tanımlanan kaynağa yükler.

public:
 cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public byte[] UploadValues (string address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValues : string * System.Collections.Specialized.NameValueCollection -> byte[]

Public Function UploadValues (address As String, data As NameValueCollection) As Byte()

Parametreler

address

String

Koleksiyonu alacak kaynağın URI'sini.

data

NameValueCollection

Kaynağa gönderilecek NameValueCollection.

Döndürülenler

Byte[]

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

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

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

-veya-

data null.

-veya-

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

-veya-

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

-veya-

Content-type üst bilgisi null veya "application/x-www-form-urlencoded" değil.

Örnekler

Aşağıdaki kod örneği kullanıcıdan bilgi toplar (ad, yaş ve adres) ve UploadValueskullanarak değerleri sunucuya gönderir. Sunucudan gelen tüm yanıtlar konsolda 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;

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;

Console::WriteLine( "Please enter the following parameters to be posted to the URL" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();

Console::Write( "Age: " );
String^ age = Console::ReadLine();

Console::Write( "Address: " );
String^ address = Console::ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );

Console::WriteLine( "\nUploading to {0} ...", uriString );
// 'The Upload(String, NameValueCollection)' implicitly method sets HTTP POST as the request method.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, myNameValueCollection );

// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {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();

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();

Console.WriteLine("Please enter the following parameters to be posted to the URL");
Console.Write("Name:");
string name = Console.ReadLine();

Console.Write("Age:");
string age = Console.ReadLine();

Console.Write("Address:");
string address = Console.ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);            
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);

Console.WriteLine("\nUploading to {0} ...",  uriString);
// 'The Upload(String,NameValueCollection)' implicitly method sets HTTP POST as the request method.            
byte[] responseArray = myWebClient.UploadValues(uriString,myNameValueCollection);

// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{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()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the URL:")
Console.Write("Name:")
Dim name As String = Console.ReadLine()

Console.Write("Age:")
Dim age As String = Console.ReadLine()

Console.Write("Address:")
Dim address As String = Console.ReadLine()

' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)

Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' The Upload(String,NameValueCollection)' method implicitly sets the HTTP POST as the request method.			
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, myNameValueCollection)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{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.

UploadValues yöntemi sunucuya bir NameValueCollection gönderir. Bu yöntem verileri karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için UploadValuesAsync yöntemlerinden birini kullanın.

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.

İçerik türü üst bilgisi nullise, UploadValues yöntemi bunu "application/x-www-form-urlencoded" olarak ayarlar.

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.

UploadValues(Uri, NameValueCollection)

Kaynak:

WebClient.cs

Belirtilen ad/değer koleksiyonunu belirtilen URI tarafından tanımlanan kaynağa yükler.

public:
 cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public byte[] UploadValues (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValues : Uri * System.Collections.Specialized.NameValueCollection -> byte[]

Public Function UploadValues (address As Uri, data As NameValueCollection) As Byte()

Parametreler

address

Uri

Koleksiyonu alacak kaynağın URI'sini.

data

NameValueCollection

Kaynağa gönderilecek NameValueCollection.

Döndürülenler

Byte[]

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

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

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

-veya-

data null.

-veya-

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

-veya-

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

-veya-

Content-type üst bilgisi null veya "application/x-www-form-urlencoded" değil.

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.

UploadValues yöntemi sunucuya bir NameValueCollection gönderir. Bu yöntem verileri karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için UploadValuesAsync yöntemlerinden birini kullanın.

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.

İçerik türü üst bilgisi nullise, UploadValues yöntemi bunu "application/x-www-form-urlencoded" olarak ayarlar.

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.

UploadValues(String, String, NameValueCollection)

Kaynak:

WebClient.cs

Belirtilen ad/değer koleksiyonunu belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler.

public:
 cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public byte[] UploadValues (string address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValues : string * string * System.Collections.Specialized.NameValueCollection -> byte[]

Public Function UploadValues (address As String, method As String, data As NameValueCollection) As Byte()

Parametreler

address

String

Koleksiyonu alacak kaynağın URI'sini.

method

String

Dosyayı 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

NameValueCollection

Kaynağa gönderilecek NameValueCollection.

Döndürülenler

Byte[]

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

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

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

-veya-

data null.

-veya-

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

-veya-

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

-veya-

Content-type üst bilgi değeri null değildir ve application/x-www-form-urlencodeddeğildir.

Örnekler

Aşağıdaki kod örneği kullanıcıdan bilgi toplar (ad, yaş ve adres) ve UploadValueskullanarak değerleri sunucuya gönderir. Sunucudan gelen tüm yanıtlar konsolda görüntülenir.

Console::Write( "\nPlease enter the URL to post data to: " );
String^ uriString = Console::ReadLine();

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

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;

Console::WriteLine( "Please enter the following parameters to be posted to the URI" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();

Console::Write( "Age: " );
String^ age = Console::ReadLine();

Console::Write( "Address: " );
String^ address = Console::ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );

// Upload the NameValueCollection.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, "POST", myNameValueCollection );

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

Console.Write("\nPlease enter the URL to post data to : ");
string uriString = Console.ReadLine();

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

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();

Console.WriteLine("Please enter the following parameters to be posted to the URI");
Console.Write("Name:");
string name = Console.ReadLine();

Console.Write("Age:");
string age = Console.ReadLine();

Console.Write("Address:");
string address = Console.ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);			
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...",  uriString);

// Upload the NameValueCollection.
byte[] responseArray = myWebClient.UploadValues(uriString,"POST",myNameValueCollection);

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

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

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

' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()

Console.WriteLine("Please enter the following parameters to be posted to the Url")
Console.Write("Name:")
Dim name As String = Console.ReadLine()

Console.Write("Age:")
Dim age As String = Console.ReadLine()

Console.Write("Address:")
Dim address As String = Console.ReadLine()

' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)

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

' Upload the NameValueCollection.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, "POST", myNameValueCollection)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{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.

UploadValues yöntemi, method parametresinde belirtilen yöntemi kullanarak bir kaynağa NameValueCollection gönderir ve sunucudan herhangi bir yanıt 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 UploadValuesAsync yöntemlerinden birini kullanın.

Content-type üst bilgisi nullise, UploadValues yöntemi bunu application/x-www-form-urlencodedolarak ayarlar.

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.

UploadValues(Uri, String, NameValueCollection)

Kaynak:

WebClient.cs

Belirtilen ad/değer koleksiyonunu belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler.

public:
 cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public byte[] UploadValues (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValues : Uri * string * System.Collections.Specialized.NameValueCollection -> byte[]

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

Parametreler

address

Uri

Koleksiyonu alacak kaynağın URI'sini.

method

String

Dosyayı 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

NameValueCollection

Kaynağa gönderilecek NameValueCollection.

Döndürülenler

Byte[]

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

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

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

-veya-

data null.

-veya-

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

-veya-

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

-veya-

Content-type üst bilgi değeri null değildir ve application/x-www-form-urlencodeddeğildir.

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.

UploadValues yöntemi, method parametresinde belirtilen yöntemi kullanarak bir kaynağa NameValueCollection gönderir ve sunucudan herhangi bir yanıt 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 UploadValuesAsync yöntemlerinden birini kullanın.

Content-type üst bilgisi nullise, UploadValues yöntemi bunu application/x-www-form-urlencodedolarak ayarlar.

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.