HttpWebRequest.EndGetRequestStream Metod

Definition

Namnområde:

System.Net

Sammansättning:

System.dll

Avslutar en asynkron begäran om att ett Stream objekt ska användas för att skriva data.

Överlagringar

Name	Description
EndGetRequestStream(IAsyncResult, TransportContext)	Avslutar en asynkron begäran om ett Stream objekt som ska användas för att skriva data och matar ut den TransportContext associerade med strömmen.
EndGetRequestStream(IAsyncResult)	Avslutar en asynkron begäran om att ett Stream objekt ska användas för att skriva data.

EndGetRequestStream(IAsyncResult, TransportContext)

Avslutar en asynkron begäran om ett Stream objekt som ska användas för att skriva data och matar ut den TransportContext associerade med strömmen.

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);

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

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

Parametrar

asyncResult

IAsyncResult

Den väntande begäran om en dataström.

context

TransportContext

För TransportContextStream.

Returer

Stream

En Stream som ska användas för att skriva begärandedata.

Undantag

ArgumentException

asyncResult returnerades inte av den aktuella instansen från ett anrop till BeginGetRequestStream(AsyncCallback, Object).

ArgumentNullException

asyncResult är null.

InvalidOperationException

Den här metoden anropades tidigare med .asyncResult

IOException

Begäran slutfördes inte och ingen ström är tillgänglig.

WebException

Abort() anropades tidigare.

-eller-

Ett fel uppstod när begäran bearbetades.

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Metoden EndGetRequestStream slutför en asynkron begäran för en dataström som startades av BeginGetRequestStream metoden och matar ut den TransportContext som är associerad med strömmen. När objektet Stream har returnerats kan du skicka data med HttpWebRequest hjälp Stream.Write av metoden .

Vissa program som använder integrerade Windows authentication med utökat skydd kan behöva köra frågor mot transportskiktet som används av HttpWebRequest för att hämta kanalbindningstoken (CBT) från den underliggande TLS-kanalen. Metoden GetRequestStream ger åtkomst till den här informationen för HTTP-metoder som har en begärandetext (POST och PUT begäranden). Detta behövs bara om programmet implementerar sin egen autentisering och behöver åtkomst till KBT.

Note

• Om du behöver ange värdet för ContentLength egenskapen innan du skriver data till dataströmmen.
• Du måste anropa Stream.Close metoden för att stänga strömmen och frigöra anslutningen för återanvändning. Om strömmen inte stängs får programmet slut på anslutningar.
• Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Se även

• TransportContext
• GetChannelBinding(ChannelBindingKind)
• System.Security.Authentication.ExtendedProtection
• ChannelBinding
• integrerad Windows-autentisering med utökat skydd

EndGetRequestStream(IAsyncResult)

Avslutar en asynkron begäran om att ett Stream objekt ska användas för att skriva 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

Parametrar

asyncResult

IAsyncResult

Den väntande begäran om en dataström.

Returer

Stream

En Stream som ska användas för att skriva begärandedata.

Undantag

ArgumentNullException

asyncResult är null.

IOException

Begäran slutfördes inte och ingen ström är tillgänglig.

ArgumentException

asyncResult returnerades inte av den aktuella instansen från ett anrop till BeginGetRequestStream(AsyncCallback, Object).

InvalidOperationException

Den här metoden anropades tidigare med .asyncResult

WebException

Abort() anropades tidigare.

-eller-

Ett fel uppstod när begäran bearbetades.

Exempel

I följande kodexempel används EndGetRequestStream metoden för att avsluta en asynkron begäran för en dataströminstans.

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

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Metoden EndGetRequestStream slutför en asynkron begäran för en dataström som startades av BeginGetRequestStream metoden. När objektet Stream har returnerats kan du skicka data med HttpWebRequest hjälp Stream.Write av metoden .

Note

• Du måste ange värdet för ContentLength egenskapen innan du skriver data till dataströmmen.
• Du måste anropa Stream.Close metoden för att stänga strömmen och frigöra anslutningen för återanvändning. Om strömmen inte stängs får programmet slut på anslutningar.
• Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.