SslApplicationProtocol Yapı

Tanım

Ad Alanı:

System.Net.Security

Bütünleştirilmiş Kod:

System.Net.Security.dll

Kaynak:

SslApplicationProtocol.cs

TLS Uygulama protokolünün değerini temsil eder.

public value class SslApplicationProtocol : IEquatable<System::Net::Security::SslApplicationProtocol>

public readonly struct SslApplicationProtocol : IEquatable<System.Net.Security.SslApplicationProtocol>

type SslApplicationProtocol = struct

Public Structure SslApplicationProtocol
Implements IEquatable(Of SslApplicationProtocol)

Devralma

Object

ValueType

SslApplicationProtocol

Uygulamalar

IEquatable<SslApplicationProtocol>

Örnekler

Aşağıdaki kod örneği, üzerinde SslStreamuygulama düzeyi protokolün anlaşmasını gösterir. Sunucu ve protocol2için protocol1 desteği tanıtıyor. İstemci ve protocol3için protocol2 desteği tanıtıyor. El sıkışması sırasında yaygın olarak desteklenen protokol (protocol2) anlaşması yapılır.

async Task Server(NetworkStream stream, X509Certificate2 serverCertificate)
{
    using var server = new SslStream(stream);

    await server.AuthenticateAsServerAsync(new SslServerAuthenticationOptions
    {
        ServerCertificate = serverCertificate,
        ApplicationProtocols = new()
        {
            new("protocol1"),
            new("protocol2"),
        }
    });

    string protocol = Encoding.ASCII.GetString(server.NegotiatedApplicationProtocol.Protocol.Span);
    System.Console.WriteLine($"Server - negotiated protocol: {protocol}");
}

async Task Client(NetworkStream stream, string hostName)
{
    using var client = new SslStream(stream);

    await client.AuthenticateAsClientAsync(new SslClientAuthenticationOptions
    {
        // the host name must match the name on the certificate used on the server side
        TargetHost = hostName,
        ApplicationProtocols = new()
        {
            new("protocol2"),
            new("protocol3")
        }
    });

    string protocol = Encoding.ASCII.GetString(client.NegotiatedApplicationProtocol.Protocol.Span);
    System.Console.WriteLine($"Client - negotiated protocol: {protocol}");
}

// possible output:
//   Server - negotiated protocol: protocol2
//   Client - negotiated protocol: protocol2

Async Function Server(stream As NetworkStream, serverCertificate As X509Certificate2) As Task
    Using serverStream As SslStream = new SslStream(stream)
        Dim options as New SslServerAuthenticationOptions() With
        {
            .ServerCertificate = serverCertificate,
            .ApplicationProtocols = New List(Of SslApplicationProtocol) From
            {
                New SslApplicationProtocol("protocol1"),
                New SslApplicationProtocol("protocol2")
            }
        }
        Await serverStream.AuthenticateAsServerAsync(options)

        Dim protocol As String = Encoding.ASCII.GetString(
            serverStream.NegotiatedApplicationProtocol.Protocol.Span)
        System.Console.WriteLine($"Server - negotiated protocol: {protocol}")
    End Using
End Function

Async Function Client(stream As NetworkStream, hostName As String ) As Task
    Using clientStream As SslStream = new SslStream(stream)
        Dim options as New SslClientAuthenticationOptions() With
        {
            .TargetHost = hostName,
            .ApplicationProtocols = New List(Of SslApplicationProtocol) From
            {
                New SslApplicationProtocol("protocol2"),
                New SslApplicationProtocol("protocol3")
            }
        }
        Await clientStream.AuthenticateAsClientAsync(options)

        Dim protocol As String = Encoding.ASCII.GetString(
            clientStream.NegotiatedApplicationProtocol.Protocol.Span)
        System.Console.WriteLine($"Client - negotiated protocol: {protocol}")
    End Using
End Function

' possible output:
'   Server - negotiated protocol: protocol2
'   Client - negotiated protocol: protocol2

Açıklamalar

Bu tür, HTTP sürümleri için önceden tanımlanmış SslApplicationProtocol değerler içeren statik alanlar içerir.

El sıkışma sırasında istemci kullanılabilir ALPN protokollerinin listesini gönderir ve sunucu bu listeden en iyi eşleşmeyi seçer.

Desteklenen protokollerin tam listesi için bkz. TLS Application-Layer Protokol Anlaşması (ALPN) Protokol Kimlikleri.

Oluşturucular

SslApplicationProtocol(Byte[])	Yeni bir SslApplicationProtocol örneğini başlatır.
SslApplicationProtocol(String)	Yeni bir SslApplicationProtocol örneğini başlatır.

Alanlar

Http11	HTTP/1.1 TLS uygulama protokollerini temsil eden bir SslApplicationProtocol alır.
Http2	Http/2 TLS uygulama protokollerini temsil eden bir SslApplicationProtocol alır.
Http3	HTTP 3.0 için bir SslApplicationProtocol örnek tanımlar.

Özellikler

Protocol

Bu SslApplicationProtocoltarafından temsil edilen geçerli bir TLS uygulama protokollerini alır.

Yöntemler

Equals(Object)	öğesini SslApplicationProtocol belirtilen nesneyle karşılaştırır.
Equals(SslApplicationProtocol)	bir SslApplicationProtocol değerini belirtilen SslApplicationProtocol örnekle karşılaştırır.
GetHashCode()	Örneğin karma kodunu SslApplicationProtocol döndürür.
ToString()	ToString() yöntemini geçersiz kılar.

İşleçler

Equality(SslApplicationProtocol, SslApplicationProtocol)	İki SslApplicationProtocol nesneyi karşılaştırmak için eşitlik işleci.
Inequality(SslApplicationProtocol, SslApplicationProtocol)	İki SslApplicationProtocol nesneyi karşılaştırmak için eşitsizlik işleci.