WebClient.UploadString Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Belirtilen dizeyi belirtilen kaynağa yükler.

Aşırı Yüklemeler

UploadString(String, String)	POST yöntemini kullanarak belirtilen dizeyi belirtilen kaynağa yükler.
UploadString(Uri, String)	POST yöntemini kullanarak belirtilen dizeyi belirtilen kaynağa yükler.
UploadString(String, String, String)	Belirtilen dizeyi belirtilen yöntemi kullanarak belirtilen kaynağa yükler.
UploadString(Uri, String, String)	Belirtilen dizeyi belirtilen yöntemi kullanarak belirtilen kaynağa yükler.

UploadString(String, String)

Kaynak:

WebClient.cs

POST yöntemini kullanarak belirtilen dizeyi belirtilen kaynağa yükler.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ data);

public string UploadString (string address, string data);

member this.UploadString : string * string -> string

Public Function UploadString (address As String, data As String) As String

Parametreler

address

String

Dizeyi alacak kaynağın URI'si. Http kaynakları için, bu URI'nin betik veya ASP sayfası gibi POST yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlaması gerekir.

data

String

Karşıya yüklenecek dize.

Döndürülenler

String

Sunucu tarafından gönderilen yanıtı içeren bir String.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

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

Örnekler

Aşağıdaki kod örneğinde bu yöntemin çağrılması gösterilmektedir.

void UploadString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   WebClient^ client = gcnew WebClient;

   // Optionally specify an encoding for uploading and downloading strings.
   client->Encoding = System::Text::Encoding::UTF8;

   // Upload the data.
   String^ reply = client->UploadString( address, data );

   // Disply the server's response.
   Console::WriteLine( reply );
}

public static void UploadString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    WebClient client = new WebClient();
    // Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8;
    // Upload the data.
    string reply = client.UploadString(address, data);
    // Display the server's response.
    Console.WriteLine(reply);
}

Public Shared Sub UploadString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim client As WebClient = New WebClient()
    '  Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8
    '  Upload the data.
    Dim reply As String = client.UploadString(address, data)
    '  Disply the server's response.
    Console.WriteLine(reply)
End Sub

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, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller. Bir dize göndermek ve sunucunun yanıtını beklerken yürütmeye devam etmek için UploadStringAsync yöntemlerinden birini kullanın.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak 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.

UploadString(Uri, String)

Kaynak:

WebClient.cs

POST yöntemini kullanarak belirtilen dizeyi belirtilen kaynağa yükler.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ data);

public string UploadString (Uri address, string data);

member this.UploadString : Uri * string -> string

Public Function UploadString (address As Uri, data As String) As String

Parametreler

address

Uri

Dizeyi alacak kaynağın URI'si. Http kaynakları için, bu URI'nin betik veya ASP sayfası gibi POST yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlaması gerekir.

data

String

Karşıya yüklenecek dize.

Döndürülenler

String

Sunucu tarafından gönderilen yanıtı içeren bir String.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

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

Bu yöntem, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller. Bir dize göndermek ve sunucunun yanıtını beklerken yürütmeye devam etmek için UploadStringAsync yöntemlerinden birini kullanın.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak 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.

UploadString(String, String, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi belirtilen yöntemi kullanarak belirtilen kaynağa yükler.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);

public string UploadString (string address, string? method, string data);

member this.UploadString : string * string * string -> string

Public Function UploadString (address As String, method As String, data As String) As String

Parametreler

address

String

Dizeyi alacak kaynağın URI'si. Bu URI, method yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlamalıdır.

method

String

Dizeyi 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

String

Karşıya yüklenecek dize.

Döndürülenler

String

Sunucu tarafından gönderilen yanıtı içeren bir String.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

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

-veya-

method içerik göndermek için kullanılamaz.

Örnekler

Aşağıdaki kod örneğinde bu yöntemin çağrılması gösterilmektedir.

void PostString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   String^ method = "POST";
   WebClient^ client = gcnew WebClient;
   String^ reply = client->UploadString( address, method, data );
   Console::WriteLine( reply );
}

public static void PostString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    string method = "POST";
    WebClient client = new WebClient();
    string reply = client.UploadString(address, method, data);

    Console.WriteLine(reply);
}

Public Shared Sub PostString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim method As String = "POST"
    Dim client As WebClient = New WebClient()
    Dim reply As String = client.UploadString(address, method, data)

    Console.WriteLine(reply)
End Sub

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, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller. Bir dize göndermek ve sunucunun yanıtını beklerken yürütmeye devam etmek için UploadStringAsync 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.

UploadString(Uri, String, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi belirtilen yöntemi kullanarak belirtilen kaynağa yükler.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);

public string UploadString (Uri address, string? method, string data);

member this.UploadString : Uri * string * string -> string

Public Function UploadString (address As Uri, method As String, data As String) As String

Parametreler

address

Uri

Dizeyi alacak kaynağın URI'si. Bu URI, method yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlamalıdır.

method

String

Dizeyi 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

String

Karşıya yüklenecek dize.

Döndürülenler

String

Sunucu tarafından gönderilen yanıtı içeren bir String.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

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

-veya-

method içerik göndermek için kullanılamaz.

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, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller. Bir dize göndermek ve sunucunun yanıtını beklerken yürütmeye devam etmek için UploadStringAsync 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.