HttpWebRequest.EndGetRequestStream Metoda

Definice

Obor názvů:: System.Net

Sestavení:: netstandard.dll, System.Net.Requests.dll

Sestavení:: System.Net.Requests.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Sestavení:: System.dll, System.Net.Requests.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Ukončí asynchronní požadavek na objekt, Stream který se má použít k zápisu dat.

Přetížení

Name	Description
EndGetRequestStream(IAsyncResult, TransportContext)	Ukončí asynchronní požadavek na objekt, Stream který se má použít k zápisu dat a výstupů TransportContext přidružených ke streamu.
EndGetRequestStream(IAsyncResult)	Ukončí asynchronní požadavek na objekt, Stream který se má použít k zápisu dat.

EndGetRequestStream(IAsyncResult, TransportContext)

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Ukončí asynchronní požadavek na objekt, Stream který se má použít k zápisu dat a výstupů TransportContext přidružených ke streamu.

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

Parametry

asyncResult: IAsyncResult

Nevyřízená žádost o datový proud

context: TransportContext

StreamPro TransportContext .

Návraty

Stream

A Stream , která se má použít k zápisu dat požadavku.

Výjimky

ArgumentException

asyncResult nebyla vrácena aktuální instancí z volání do BeginGetRequestStream(AsyncCallback, Object).

ArgumentNullException

asyncResult je null.

InvalidOperationException

Tato metoda byla volána dříve pomocí asyncResult.

IOException

Požadavek se nedokončil a není k dispozici žádný datový proud.

WebException

Abort() byl dříve volána.

-nebo-

Při zpracování požadavku došlo k chybě.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda EndGetRequestStream dokončí asynchronní požadavek na datový proud, který byla spuštěna BeginGetRequestStream metodou, a výstupy TransportContext přidružené ke streamu. Po vrácení objektu Stream můžete pomocí metody odeslat data pomocí HttpWebRequest Stream.Write metody.

Některé aplikace, které používají integrované ověřování systému Windows s rozšířenou ochranou, mohou být schopné dotazovat vrstvu přenosu používanou HttpWebRequest k načtení tokenu vazby kanálu (CBT) z podkladového kanálu TLS. Metoda GetRequestStream poskytuje přístup k tomuto informacím pro metody HTTP, které mají tělo požadavku (POST a PUT požadavky). To je potřeba jenom v případě, že aplikace implementuje vlastní ověřování a potřebuje přístup k CBT.

Poznámka

Pokud potřebujete nastavit hodnotu ContentLength vlastnosti před zápisem dat do datového proudu.
Voláním metody zavřete Stream.Close datový proud a uvolněte připojení pro opakované použití. Při zavření datového proudu dojde k výpadku připojení vaší aplikace.
Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

Platí pro

EndGetRequestStream(IAsyncResult)

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Zdroj:: HttpWebRequest.cs

Ukončí asynchronní požadavek na objekt, Stream který se má použít k zápisu dat.

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

Nevyřízená žádost o datový proud

Návraty

Stream

A Stream , která se má použít k zápisu dat požadavku.

Výjimky

ArgumentNullException

asyncResult je null.

IOException

Požadavek se nedokončil a není k dispozici žádný datový proud.

ArgumentException

asyncResult nebyla vrácena aktuální instancí z volání do BeginGetRequestStream(AsyncCallback, Object).

InvalidOperationException

Tato metoda byla volána dříve pomocí asyncResult.

WebException

Abort() byl dříve volána.

-nebo-

Při zpracování požadavku došlo k chybě.

Příklady

Následující příklad kódu používá metodu EndGetRequestStream k ukončení asynchronního požadavku na instanci streamu.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda EndGetRequestStream dokončí asynchronní požadavek na datový proud, který metoda spustila BeginGetRequestStream . Po vrácení objektu Stream můžete pomocí metody odeslat data pomocí HttpWebRequest Stream.Write metody.

Poznámka

Před zápisem ContentLength dat do datového proudu je nutné nastavit hodnotu vlastnosti.
Voláním metody zavřete Stream.Close datový proud a uvolněte připojení pro opakované použití. Při zavření datového proudu dojde k výpadku připojení vaší aplikace.
Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

HttpWebRequest.EndGetRequestStream Metoda

Definice

Přetížení

EndGetRequestStream(IAsyncResult, TransportContext)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

EndGetRequestStream(IAsyncResult)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Váš názor