HttpWebRequest.EndGetRequestStream Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.Requests.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Kończy asynchroniczne żądanie dla Stream obiektu używanego do zapisywania danych.

Przeciążenia

EndGetRequestStream(IAsyncResult, TransportContext)	Kończy asynchroniczne żądanie dla Stream obiektu używanego do zapisywania danych i wyprowadzania TransportContext skojarzonych ze strumieniem.
EndGetRequestStream(IAsyncResult)	Kończy asynchroniczne żądanie dla Stream obiektu używanego do zapisywania danych.

EndGetRequestStream(IAsyncResult, TransportContext)

Kończy asynchroniczne żądanie dla Stream obiektu używanego do zapisywania danych i wyprowadzania TransportContext skojarzonych ze strumieniem.

public:
 System::IO::Stream ^ EndGetRequestStream(IAsyncResult ^ asyncResult, [Runtime::InteropServices::Out] System::Net::TransportContext ^ % context);

public:
 System::IO::Stream ^ EndGetRequestStream(IAsyncResult ^ asyncResult, [Runtime::InteropServices::Out] System::Net::TransportContext ^ % transportContext);

public System.IO.Stream EndGetRequestStream (IAsyncResult asyncResult, 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 transportContext);

override this.EndGetRequestStream : IAsyncResult * TransportContext -> System.IO.Stream

override this.EndGetRequestStream : IAsyncResult * TransportContext -> System.IO.Stream

Public Function EndGetRequestStream (asyncResult As IAsyncResult, ByRef context As TransportContext) As Stream

Public Function EndGetRequestStream (asyncResult As IAsyncResult, ByRef transportContext As TransportContext) As Stream

Parametry

asyncResult: IAsyncResult

Oczekujące żądanie dla strumienia.

contexttransportContext: TransportContext

Element TransportContext dla .Stream

Zwraca

Stream

A Stream do zapisywania danych żądania.

Wyjątki

ArgumentException

asyncResultnie zostało zwrócone przez bieżące wystąpienie z wywołania metody .BeginGetRequestStream(AsyncCallback, Object)

ArgumentNullException

asyncResult to null.

InvalidOperationException

Ta metoda została wywołana wcześniej przy użyciu metody asyncResult.

IOException

Żądanie nie zostało ukończone i żaden strumień nie jest dostępny.

WebException

Abort() wcześniej wywoływana.

-lub- Wystąpił błąd podczas przetwarzania żądania.

Uwagi

Metoda EndGetRequestStream kończy asynchroniczne żądanie dla strumienia, które zostało uruchomione przez BeginGetRequestStream metodę i generuje dane wyjściowe TransportContext skojarzone ze strumieniem. Stream Po zwróceniu obiektu można wysłać dane za HttpWebRequest pomocą metody .Stream.Write

Niektóre aplikacje korzystające ze zintegrowanego uwierzytelniania Windows z rozszerzoną ochroną mogą wymagać wysyłania zapytań do warstwy transportu używanej przez HttpWebRequest program w celu pobrania tokenu powiązania kanału (CBT) z bazowego kanału TLS. Metoda GetRequestStream zapewnia dostęp do tych informacji dla metod HTTP, które mają treść żądania (POST i PUT żądania). Jest to konieczne tylko wtedy, gdy aplikacja implementuje własne uwierzytelnianie i wymaga dostępu do cbt.

Uwaga

Jeśli aplikacja musi ustawić wartość ContentLength właściwości, należy to zrobić przed pobraniem strumienia i zapisaniem do niego danych.

Przestroga

Należy wywołać metodę Stream.Close , aby zamknąć strumień i zwolnić połączenie do ponownego użycia. Niepowodzenie zamknięcia strumienia powoduje, że aplikacja kończy się połączeniami.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Zobacz też

Dotyczy

EndGetRequestStream(IAsyncResult)

Kończy asynchroniczne żądanie dla Stream obiektu używanego do zapisywania danych.

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

Parametry

asyncResult: IAsyncResult

Oczekujące żądanie dla strumienia.

Zwraca

Stream

A Stream do zapisywania danych żądania.

Wyjątki

ArgumentNullException

asyncResult to null.

IOException

Żądanie nie zostało ukończone i żaden strumień nie jest dostępny.

ArgumentException

asyncResultnie zostało zwrócone przez bieżące wystąpienie z wywołania metody .BeginGetRequestStream(AsyncCallback, Object)

InvalidOperationException

Ta metoda została wywołana wcześniej przy użyciu metody asyncResult.

WebException

Abort() wcześniej wywoływana.

-lub- Wystąpił błąd podczas przetwarzania żądania.

Przykłady

W poniższym przykładzie kodu użyto EndGetRequestStream metody , aby zakończyć żądanie asynchroniczne dla wystąpienia strumienia.

#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

Uwagi

Metoda EndGetRequestStream kończy asynchroniczne żądanie strumienia, które zostało uruchomione przez metodę BeginGetRequestStream . Stream Po zwróceniu obiektu można wysłać dane za HttpWebRequest pomocą metody .Stream.Write

Uwaga

Przed zapisaniem danych w strumieniu należy ustawić wartość ContentLength właściwości .

Przestroga

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy

HttpWebRequest.EndGetRequestStream Metoda

Definicja

Przeciążenia

EndGetRequestStream(IAsyncResult, TransportContext)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

EndGetRequestStream(IAsyncResult)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby