Freigeben über


HybridConnectionListener Klasse

Definition

Stellt einen Listener zum Akzeptieren von HybridConnections von Remoteclients bereit.

public class HybridConnectionListener : Microsoft.Azure.Relay.IConnectionStatus
type HybridConnectionListener = class
    interface IConnectionStatus
Public Class HybridConnectionListener
Implements IConnectionStatus
Vererbung
HybridConnectionListener
Implementiert

Konstruktoren

HybridConnectionListener(String)

Erstellt eine neue instance der HybridConnectionListener Verwendung der angegebenen Verbindungszeichenfolge. Verwenden Sie diese Überladung nur, wenn AAD nicht die Authentifizierungsmethode ist.

HybridConnectionListener(String, String)

Erstellt eine neue instance von HybridConnectionListener aus einer Verbindungszeichenfolge und dem angegebenen HybridConection-Pfad. Verwenden Sie diese Überladung nur, wenn die Verbindungszeichenfolge die EntityPath -Eigenschaft nicht verwendet und AAD nicht die Authentifizierungsmethode ist.

HybridConnectionListener(Uri, TokenProvider)

Erstellen Sie eine neue HybridConnectionListener-instance zum Akzeptieren von HybridConnections.

Eigenschaften

AcceptHandler

Ermöglicht die Installation eines benutzerdefinierten Handlers, der Anforderungsheader überprüfen, Antwortheader steuern, entscheiden kann, ob eine Websocketsupgradeanforderung akzeptiert oder abgelehnt werden soll, und den status Code/Beschreibung bei Ablehnung steuern kann. Der AcceptHandler sollte true zurückgeben, um eine Clientanforderung zu akzeptieren, oder false zum Ablehnen.

Address

Ruft die Adresse ab, an der auf HybridConnections lauscht werden soll. Diese Adresse sollte das Format "sb://contoso.servicebus.windows.net/yourhybridconnection" haben.

ClientWebSocketFactory

Benutzerdefinierte ClientWebSocket-Implementierung.

IsOnline

Ruft einen Wert ab, der bestimmt, ob die Verbindung online ist.

KeepAliveInterval

Das Keep-Alive-Intervall von Websocket.

LastError

Ruft den letzten Fehler ab, der beim Versuch aufgetreten ist, die Verbindung aus dem Offlinezustand wiederherzustellen.

Proxy

Ruft Proxyinformationen für die Verbindung mit ServiceBus ab oder legt diese fest.

RequestHandler

Installiert einen Handler für Hybrid-HTTP-Anforderungen.

TokenProvider

Ruft den TokenProvider zum Authentifizieren dieses HybridConnection-Listeners ab.

TrackingContext

Ruft den TrackingContext für diesen Listener ab.

UseBuiltInClientWebSocket

Steuert, ob das ClientWebSocket von .NET Core oder eine benutzerdefinierte Implementierung verwendet wird. Wenn eine benutzerdefinierte ClientWebSocketFactory Konfiguriert ist, wird diese Eigenschaft ignoriert.

Methoden

AcceptConnectionAsync()

Akzeptiert eine neue HybridConnection, die von einem Remoteclient initiiert wurde, und gibt den Stream zurück.

CloseAsync()

Schließt das HybridConnectionListener mithilfe des Standardtimeouts. Sofern nicht in der Verbindungszeichenfolge angegeben, ist der Standardwert 1 Minute.

CloseAsync(CancellationToken)

Schließt das HybridConnectionListener mithilfe des bereitgestellten CancellationToken.

CloseAsync(TimeSpan)

Schließt das HybridConnectionListener mithilfe des angegebenen Timeouts.

GetRuntimeInformationAsync()

Ruft die HybridConnectionRuntimeInformation für diese HybridConnection-Entität unter Verwendung des Standardtimeouts ab. Sofern nicht in der Verbindungszeichenfolge angegeben, ist der Standardwert 1 Minute.

GetRuntimeInformationAsync(CancellationToken)

Ruft die HybridConnectionRuntimeInformation für diese HybridConnection-Entität mithilfe des bereitgestellten CancellationToken ab.

OpenAsync()

Öffnet den HybridConnectionListener und registriert es als Listener in ServiceBus. Sofern nicht in der Verbindungszeichenfolge angegeben, ist der Standardwert 1 Minute.

OpenAsync(CancellationToken)

Öffnet den HybridConnectionListener und registriert es als Listener in ServiceBus.

OpenAsync(TimeSpan)

Öffnet den HybridConnectionListener und registriert es als Listener in ServiceBus.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. Enthält eine TrackingId für die End-to-End-Korrelation.

Ereignisse

Connecting

Wird ausgelöst, wenn der Listener versucht, nach einem Verbindungsverlust wieder eine Verbindung mit ServiceBus herzustellen. Weitere Informationen finden Sie unter LastError.

Offline

Wird ausgelöst, wenn der Listener nicht mehr versucht, eine Verbindung mit ServiceBus wiederherzustellen. Gründe hierfür sind das schließen des benutzerinitiierten Listeners oder das HybridConnection-Verwaltungsobjekt wurde gelöscht (z. B. über das Portal oder ARM). Überprüfen Sie LastError, um weitere Details zu erhalten, wenn dieses Ereignis unerwartet ausgelöst wird.

Online

Wird ausgelöst, wenn der Listener erfolgreich eine Verbindung mit ServiceBus hergestellt oder wieder hergestellt hat. LastError ist an diesem Punkt NULL.

Gilt für: