Bagikan melalui

HttpWebRequest.EndGetRequestStream Metode

  • Referensi

Definisi

Ruang nama:
System.Net
Rakitan:
System.Net.Requests.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Mengakhiri permintaan asinkron untuk objek Stream yang digunakan untuk menulis data.

Overload

EndGetRequestStream(IAsyncResult, TransportContext)

Mengakhiri permintaan asinkron untuk objek Stream yang digunakan untuk menulis data dan menghasilkan TransportContext yang terkait dengan aliran.
EndGetRequestStream(IAsyncResult)

Mengakhiri permintaan asinkron untuk objek Stream yang digunakan untuk menulis data.

EndGetRequestStream(IAsyncResult, TransportContext)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Mengakhiri permintaan asinkron untuk objek Stream yang digunakan untuk menulis data dan menghasilkan TransportContext yang terkait dengan aliran.

public:
 System::IO::Stream ^ EndGetRequestStream(IAsyncResult ^ asyncResult, [Runtime::InteropServices::Out] System::Net::TransportContext ^ % context);
public System.IO.Stream EndGetRequestStream (IAsyncResult asyncResult, out System.Net.TransportContext? context);
public System.IO.Stream EndGetRequestStream (IAsyncResult asyncResult, out System.Net.TransportContext context);
override this.EndGetRequestStream : IAsyncResult * TransportContext -> System.IO.Stream
Public Function EndGetRequestStream (asyncResult As IAsyncResult, ByRef context As TransportContext) As Stream

Parameter

asyncResult
IAsyncResult

Permintaan tertunda untuk streaming.

context
TransportContext

TransportContext untuk Stream.

Mengembalikan

Stream

Stream yang digunakan untuk menulis data permintaan.

Pengecualian

ArgumentException

asyncResult tidak dikembalikan oleh instans saat ini dari panggilan ke BeginGetRequestStream(AsyncCallback, Object).

ArgumentNullException

asyncResult null.

InvalidOperationException

Metode ini dipanggil sebelumnya menggunakan asyncResult.

IOException

Permintaan tidak selesai, dan tidak ada aliran yang tersedia.

WebException

Abort() sebelumnya dipanggil.

-atau-

Terjadi kesalahan saat memproses permintaan.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode EndGetRequestStream menyelesaikan permintaan asinkron untuk aliran yang dimulai oleh metode BeginGetRequestStream dan menghasilkan TransportContext yang terkait dengan aliran. Setelah objek Stream dikembalikan, Anda dapat mengirim data dengan HttpWebRequest dengan menggunakan metode Stream.Write.

Beberapa aplikasi yang menggunakan autentikasi Windows terintegrasi dengan perlindungan yang diperluas mungkin harus dapat mengkueri lapisan transportasi yang digunakan oleh HttpWebRequest untuk mengambil token pengikatan saluran (CBT) dari saluran TLS yang mendasar. Metode GetRequestStream menyediakan akses ke informasi ini untuk metode HTTP yang memiliki isi permintaan (POST dan permintaan PUT). Ini hanya diperlukan jika aplikasi menerapkan autentikasinya sendiri dan membutuhkan akses ke CBT.

Nota

  • Jika Anda perlu mengatur nilai properti ContentLength sebelum menulis data ke aliran.
  • Anda harus memanggil metode Stream.Close untuk menutup aliran dan merilis koneksi untuk digunakan kembali. Kegagalan untuk menutup aliran menyebabkan aplikasi Anda kehabisan koneksi.
  • Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Lihat juga

Berlaku untuk

EndGetRequestStream(IAsyncResult)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Mengakhiri permintaan asinkron untuk objek Stream yang digunakan untuk menulis data.

public:
 override System::IO::Stream ^ EndGetRequestStream(IAsyncResult ^ asyncResult);
public override System.IO.Stream EndGetRequestStream (IAsyncResult asyncResult);
override this.EndGetRequestStream : IAsyncResult -> System.IO.Stream
Public Overrides Function EndGetRequestStream (asyncResult As IAsyncResult) As Stream

Parameter

asyncResult
IAsyncResult

Permintaan tertunda untuk streaming.

Mengembalikan

Stream

Stream yang digunakan untuk menulis data permintaan.

Pengecualian

ArgumentNullException

asyncResult null.

IOException

Permintaan tidak selesai, dan tidak ada aliran yang tersedia.

ArgumentException

asyncResult tidak dikembalikan oleh instans saat ini dari panggilan ke BeginGetRequestStream(AsyncCallback, Object).

InvalidOperationException

Metode ini dipanggil sebelumnya menggunakan asyncResult.

WebException

Abort() sebelumnya dipanggil.

-atau-

Terjadi kesalahan saat memproses permintaan.

Contoh

Contoh kode berikut menggunakan metode EndGetRequestStream untuk mengakhiri permintaan asinkron untuk instans aliran.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::IO;
using namespace System::Text;
using namespace System::Threading;
ref class HttpWebRequestBeginGetRequest
{
public:
   static ManualResetEvent^ allDone = gcnew ManualResetEvent( false );
   static void Main()
   {
      
      // Create a new HttpWebRequest object.
      HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com/example.aspx" ));
      
      // Set the ContentType property.
      request->ContentType = "application/x-www-form-urlencoded";
      
      // Set the Method property to 'POST' to post data to the Uri.
      request->Method = "POST";
      
      // Start the asynchronous operation.    
      AsyncCallback^ del = gcnew AsyncCallback(GetRequestStreamCallback);
      request->BeginGetRequestStream( del, request );
      
      // Keep the main thread from continuing while the asynchronous
      // operation completes. A real world application
      // could do something useful such as updating its user interface. 
      allDone->WaitOne();
    }
      

private:
    static void GetRequestStreamCallback(IAsyncResult^ asynchronousResult)
    {
        HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(asynchronousResult->AsyncState);
        
        // End the operation
        Stream^ postStream = request->EndGetRequestStream(asynchronousResult);

        Console::WriteLine("Please enter the input data to be posted:");
        String^ postData = Console::ReadLine();

        // Convert the string into a byte array.
        array<Byte>^ByteArray = Encoding::UTF8->GetBytes(postData);

        // Write to the request stream.
        postStream->Write(ByteArray, 0, postData->Length);
        postStream->Close();

        // Start the asynchronous operation to get the response
        AsyncCallback^ del = gcnew AsyncCallback(GetResponseCallback);
        request->BeginGetResponse(del, request);
    }

   static void GetResponseCallback(IAsyncResult^ asynchronousResult)
   {
      HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(asynchronousResult->AsyncState);

      // End the operation
      HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->EndGetResponse(asynchronousResult));
      Stream^ streamResponse = response->GetResponseStream();
      StreamReader^ streamRead = gcnew StreamReader(streamResponse);
      String^ responseString = streamRead->ReadToEnd();
      Console::WriteLine(responseString);
      // Close the stream object
      streamResponse->Close();
      streamRead->Close();

      // Release the HttpWebResponse
      response->Close();
      allDone->Set();
   }
};

void main()
{
   HttpWebRequestBeginGetRequest::Main();
}

using System;
using System.Net;
using System.IO;
using System.Text;
using System.Threading;

class HttpWebRequestBeginGetRequest
{
    private static ManualResetEvent allDone = new ManualResetEvent(false);

    public static void Main(string[] args)
    {


        // Create a new HttpWebRequest object.
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create("http://www.contoso.com/example.aspx");

        request.ContentType = "application/x-www-form-urlencoded";

        // Set the Method property to 'POST' to post data to the URI.
        request.Method = "POST";

        // start the asynchronous operation
        request.BeginGetRequestStream(new AsyncCallback(GetRequestStreamCallback), request);

        // Keep the main thread from continuing while the asynchronous
        // operation completes. A real world application
        // could do something useful such as updating its user interface.
        allDone.WaitOne();
    }

    private static void GetRequestStreamCallback(IAsyncResult asynchronousResult)
    {
        HttpWebRequest request = (HttpWebRequest)asynchronousResult.AsyncState;

        // End the operation
        Stream postStream = request.EndGetRequestStream(asynchronousResult);

        Console.WriteLine("Please enter the input data to be posted:");
        string postData = Console.ReadLine();

        // Convert the string into a byte array.
        byte[] byteArray = Encoding.UTF8.GetBytes(postData);

        // Write to the request stream.
        postStream.Write(byteArray, 0, postData.Length);
        postStream.Close();

        // Start the asynchronous operation to get the response
        request.BeginGetResponse(new AsyncCallback(GetResponseCallback), request);
    }

    private static void GetResponseCallback(IAsyncResult asynchronousResult)
    {
        HttpWebRequest request = (HttpWebRequest)asynchronousResult.AsyncState;

        // End the operation
        HttpWebResponse response = (HttpWebResponse)request.EndGetResponse(asynchronousResult);
        Stream streamResponse = response.GetResponseStream();
        StreamReader streamRead = new StreamReader(streamResponse);
        string responseString = streamRead.ReadToEnd();
        Console.WriteLine(responseString);
        // Close the stream object
        streamResponse.Close();
        streamRead.Close();

        // Release the HttpWebResponse
        response.Close();
        allDone.Set();
    }
}

Imports System.Net
Imports System.IO
Imports System.Text
Imports System.Threading

Class HttpWebRequestBeginGetRequest
    Public Shared allDone As New ManualResetEvent(False)

    Shared Sub Main()


        ' Create a new HttpWebRequest object.
        Dim request As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com/example.aspx"), _
                 HttpWebRequest)

        ' Set the ContentType property.
        request.ContentType = "application/x-www-form-urlencoded"

        '  Set the Method property to 'POST' to post data to the URI.
        request.Method = "POST"

        ' Start the asynchronous operation.		
        Dim result As IAsyncResult = _
            CType(request.BeginGetRequestStream(AddressOf GetRequestStreamCallback, request), _
            IAsyncResult)

        ' Keep the main thread from continuing while the asynchronous
        ' operation completes. A real world application
        ' could do something useful such as updating its user interface. 
        allDone.WaitOne()
    End Sub

    Private Shared Sub GetRequestStreamCallback(ByVal asynchronousResult As IAsyncResult)
        Dim request As HttpWebRequest = CType(asynchronousResult.AsyncState, HttpWebRequest)
        
        ' End the operation
        Dim postStream As Stream = request.EndGetRequestStream(asynchronousResult)
        Console.WriteLine("Please enter the input data to be posted:")
        Dim postData As [String] = Console.ReadLine()
        
        '  Convert the string into byte array.
        Dim byteArray As Byte() = Encoding.UTF8.GetBytes(postData)

        ' Write to the stream.
        postStream.Write(byteArray, 0, postData.Length)
        postStream.Close()

        ' Start the asynchronous operation to get the response
        Dim result As IAsyncResult = _
            CType(request.BeginGetResponse(AddressOf GetResponseCallback, request), _
            IAsyncResult)
    End Sub

    Private Shared Sub GetResponseCallback(ByVal asynchronousResult As IAsyncResult)
        Dim request As HttpWebRequest = CType(asynchronousResult.AsyncState, HttpWebRequest)
        
        '  Get the response.
        Dim response As HttpWebResponse = CType(request.EndGetResponse(asynchronousResult), _
           HttpWebResponse)
        
        Dim streamResponse As Stream = response.GetResponseStream()
        Dim streamRead As New StreamReader(streamResponse)
        Dim responseString As String = streamRead.ReadToEnd()
        
        Console.WriteLine(responseString)
        
        ' Close Stream object.
        streamResponse.Close()
        streamRead.Close()

        ' Release the HttpWebResponse.
        allDone.Set()
        response.Close()
    End Sub
            
End Class

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode EndGetRequestStream menyelesaikan permintaan asinkron untuk aliran yang dimulai dengan metode BeginGetRequestStream. Setelah objek Stream dikembalikan, Anda dapat mengirim data dengan HttpWebRequest dengan menggunakan metode Stream.Write.

Nota

  • Anda harus mengatur nilai properti ContentLength sebelum menulis data ke aliran.
  • Anda harus memanggil metode Stream.Close untuk menutup aliran dan merilis koneksi untuk digunakan kembali. Kegagalan untuk menutup aliran menyebabkan aplikasi Anda kehabisan koneksi.
  • Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Berlaku untuk