Freigeben über


FabricClient Konstruktoren

Definition

Überlädt

FabricClient()

Initialisiert eine neue Instanz der FabricClient-Klasse. Dieser Konstruktor sollte von Code verwendet werden, der innerhalb des Clusters ausgeführt wird. Es ermöglicht dem FabricClient instance, eine Verbindung mit dem Cluster über den lokalen Gatewaydienst herzustellen, der auf demselben Knoten ausgeführt wird.

FabricClient(FabricClientRole)

Initialisiert einen neuen instance der FabricClient -Klasse mit der angegebenen Fabric-Clientrolle : FabricClientRole.

FabricClient(FabricClientSettings)

Initialisiert einen neuen instance der FabricClient -Klasse mit dem gewünschten FabricClientSettings. Wenn sich im FabricClient selben Cluster wie der Dienst befindet, verwenden Sie einen Lokalen FabricClient. Local FabricClient ist ein Feature von Service Fabric, das es ermöglicht FabricClient , eine Verbindung mit dem lokalen Gatewaydienst herzustellen, anstatt aus einer Liste zu wählen. Auf diese Weise kann Ihr Client einen zusätzlichen Netzwerkhop umgehen. Falls ein Dienst eine andere Dienstpartition im selben Cluster auflöst, empfiehlt es sich, Lokal FabricClientzu verwenden, da dies den automatischen Lastenausgleich ermöglicht und die Leistung verbessert.

FabricClient(String[])

Initialisiert eine neue instance der FabricClient -Klasse mit den angegebenen Service Fabric Gateway-Adressen. Bei diesen Hostendpunkten handelt es sich um eine Liste von durch ":" getrennten Zeichenfolgen, wobei der erste Teil die IP-Adresse des Clusters und der zweite Teil der Clientverbindungs-Endpunkt-Port ist.

FabricClient(FabricClientSettings, String[])

Initialisiert einen neuen instance der -Klasse mit den FabricClient angegebenen Service Fabric Gateway-Adressen und dem gewünschten FabricClientSettings.

FabricClient(SecurityCredentials, String[])

Initialisiert einen neuen instance der -Klasse mit den FabricClient angegebenen Service Fabric Gateway-Adressen und SecurityCredentials.

FabricClient(TimeSpan, String[])
Veraltet.

VERALTET. Initialisiert eine neue instance der -Klasse mit den FabricClient angegebenen KeepAliveInterval- und Service Fabric-Gatewayadressen (hostEndpoints).

FabricClient(SecurityCredentials, FabricClientSettings, String[])

Initialisiert eine neue instance der -Klasse mit den FabricClient angegebenen Service Fabric Gateway-Adressen SecurityCredentials und FabricClientSettings.

FabricClient(SecurityCredentials, TimeSpan, String[])
Veraltet.

VERALTET. Initialisiert eine neue instance der -Klasse mit angegebenen FabricClient Anmeldeinformationen, keepAliveInterval- und Service Fabric-Gatewayadressen (hostEndpoints).

FabricClient()

Initialisiert eine neue Instanz der FabricClient-Klasse. Dieser Konstruktor sollte von Code verwendet werden, der innerhalb des Clusters ausgeführt wird. Es ermöglicht dem FabricClient instance, eine Verbindung mit dem Cluster über den lokalen Gatewaydienst herzustellen, der auf demselben Knoten ausgeführt wird.

public FabricClient ();
Public Sub New ()

Hinweise

Da dieser Konstruktor den lokalen Gatewaydienst verwendet, der auf demselben Knoten ausgeführt wird, um eine Verbindung mit dem Cluster herzustellen, kann Ihr Client einen zusätzlichen Netzwerkhop umgehen. Um eine Verbindung mit einem Cluster aus Code herzustellen, der außerhalb des Clusters ausgeführt wird, verwenden Sie einen anderen Konstruktor, mit dem Sie die Verbindungsparameter explizit angeben können.

Gilt für:

FabricClient(FabricClientRole)

Initialisiert einen neuen instance der FabricClient -Klasse mit der angegebenen Fabric-Clientrolle : FabricClientRole.

public FabricClient (System.Fabric.FabricClientRole clientRole);
new System.Fabric.FabricClient : System.Fabric.FabricClientRole -> System.Fabric.FabricClient
Public Sub New (clientRole As FabricClientRole)

Parameter

clientRole
FabricClientRole

Die Fabricclientrolle.

Gilt für:

FabricClient(FabricClientSettings)

Initialisiert einen neuen instance der FabricClient -Klasse mit dem gewünschten FabricClientSettings. Wenn sich im FabricClient selben Cluster wie der Dienst befindet, verwenden Sie einen Lokalen FabricClient. Local FabricClient ist ein Feature von Service Fabric, das es ermöglicht FabricClient , eine Verbindung mit dem lokalen Gatewaydienst herzustellen, anstatt aus einer Liste zu wählen. Auf diese Weise kann Ihr Client einen zusätzlichen Netzwerkhop umgehen. Falls ein Dienst eine andere Dienstpartition im selben Cluster auflöst, empfiehlt es sich, Lokal FabricClientzu verwenden, da dies den automatischen Lastenausgleich ermöglicht und die Leistung verbessert.

public FabricClient (System.Fabric.FabricClientSettings settings);
new System.Fabric.FabricClient : System.Fabric.FabricClientSettings -> System.Fabric.FabricClient
Public Sub New (settings As FabricClientSettings)

Parameter

settings
FabricClientSettings

Die vom Fabric-Client verwendeten Fabric-Clienteinstellungen.

Gilt für:

FabricClient(String[])

Initialisiert eine neue instance der FabricClient -Klasse mit den angegebenen Service Fabric Gateway-Adressen. Bei diesen Hostendpunkten handelt es sich um eine Liste von durch ":" getrennten Zeichenfolgen, wobei der erste Teil die IP-Adresse des Clusters und der zweite Teil der Clientverbindungs-Endpunkt-Port ist.

public FabricClient (params string[] hostEndpoints);
new System.Fabric.FabricClient : string[] -> System.Fabric.FabricClient
Public Sub New (ParamArray hostEndpoints As String())

Parameter

hostEndpoints
String[]

Definiert den Satz von Gatewayadressen, die zum FabricClient Herstellen einer Verbindung mit dem Cluster verwendet werden können.

Gilt für:

FabricClient(FabricClientSettings, String[])

Initialisiert einen neuen instance der -Klasse mit den FabricClient angegebenen Service Fabric Gateway-Adressen und dem gewünschten FabricClientSettings.

public FabricClient (System.Fabric.FabricClientSettings settings, params string[] hostEndpoints);
new System.Fabric.FabricClient : System.Fabric.FabricClientSettings * string[] -> System.Fabric.FabricClient
Public Sub New (settings As FabricClientSettings, ParamArray hostEndpoints As String())

Parameter

settings
FabricClientSettings

Die Fabricclienteinstellungen.

hostEndpoints
String[]

Definiert den Satz von Gatewayadressen, die zum FabricClient Herstellen einer Verbindung mit dem Cluster verwendet werden können.

Gilt für:

FabricClient(SecurityCredentials, String[])

Initialisiert einen neuen instance der -Klasse mit den FabricClient angegebenen Service Fabric Gateway-Adressen und SecurityCredentials.

public FabricClient (System.Fabric.SecurityCredentials credential, params string[] hostEndpoints);
new System.Fabric.FabricClient : System.Fabric.SecurityCredentials * string[] -> System.Fabric.FabricClient
Public Sub New (credential As SecurityCredentials, ParamArray hostEndpoints As String())

Parameter

credential
SecurityCredentials

SecurityCredentialsdefiniert die Sicherheitseinstellungen für.FabricClient

hostEndpoints
String[]

Definiert den Satz von Gatewayadressen, die zum FabricClient Herstellen einer Verbindung mit dem Cluster verwendet werden können.

Gilt für:

FabricClient(TimeSpan, String[])

Achtung

Deprecated

VERALTET. Initialisiert eine neue instance der -Klasse mit den FabricClient angegebenen KeepAliveInterval- und Service Fabric-Gatewayadressen (hostEndpoints).

[System.Obsolete("Deprecated", true)]
public FabricClient (TimeSpan keepAliveInterval, params string[] hostEndpoints);
[<System.Obsolete("Deprecated", true)>]
new System.Fabric.FabricClient : TimeSpan * string[] -> System.Fabric.FabricClient
Public Sub New (keepAliveInterval As TimeSpan, ParamArray hostEndpoints As String())

Parameter

keepAliveInterval
TimeSpan

Definiert das periodische Keep Alive-Nachrichtenintervall.

hostEndpoints
String[]

Definiert den Satz von Gatewayadressen, die zum FabricClient Herstellen einer Verbindung mit dem Cluster verwendet werden können.

Attribute

Hinweise

Wenn zwischen der Verbindung zwischen dem Client und dem Cluster externe Geräte vorhanden sind, die regelmäßige Nachrichten erfordern, um die Verbindung aufrechtzuerhalten, sollten Sie unbedingt das KeepAlive-Feature von FabricClient verwenden. Während der Initialisierung von FabricClient können Benutzer einen TimeSpan-KeepAliveInterval angeben. Wenn dieses Argument angegeben ist, sendet der FabricClient regelmäßig einen Ping an den Service Fabric Gateway-Dienst, mit dem er derzeit kommuniziert, solange ein ausstehender Vorgang vorliegt. Ein Beispiel für ein Szenario, in dem dieses Feature nützlich ist, ist Windows Azure. Wenn sich der FabricClient außerhalb von Windows Azure befindet und sich der Cluster innerhalb von Windows Azure befindet, werden alle Verbindungen über die Azure Load Balancer (ALB) ausgeführt. ALB beendet Verbindungen, die sich mehr als 60 Sekunden im Leerlauf befinden. Daher sollte in diesen Situationen FabricClient mit KeepAliveInterval auf <59 Sekunden festgelegt werden (20 -30 wird empfohlen).

Gilt für:

FabricClient(SecurityCredentials, FabricClientSettings, String[])

Initialisiert eine neue instance der -Klasse mit den FabricClient angegebenen Service Fabric Gateway-Adressen SecurityCredentials und FabricClientSettings.

public FabricClient (System.Fabric.SecurityCredentials credential, System.Fabric.FabricClientSettings settings, params string[] hostEndpoints);
new System.Fabric.FabricClient : System.Fabric.SecurityCredentials * System.Fabric.FabricClientSettings * string[] -> System.Fabric.FabricClient
Public Sub New (credential As SecurityCredentials, settings As FabricClientSettings, ParamArray hostEndpoints As String())

Parameter

credential
SecurityCredentials

SecurityCredentialsdefiniert die Sicherheitseinstellungen für.FabricClient

settings
FabricClientSettings

Die Fabricclienteinstellungen.

hostEndpoints
String[]

Definiert den Satz von Gatewayadressen, die zum FabricClient Herstellen einer Verbindung mit dem Cluster verwendet werden können.

Gilt für:

FabricClient(SecurityCredentials, TimeSpan, String[])

Achtung

Deprecated

VERALTET. Initialisiert eine neue instance der -Klasse mit angegebenen FabricClient Anmeldeinformationen, keepAliveInterval- und Service Fabric-Gatewayadressen (hostEndpoints).

[System.Obsolete("Deprecated", true)]
public FabricClient (System.Fabric.SecurityCredentials credential, TimeSpan keepAliveInterval, params string[] hostEndpoints);
[<System.Obsolete("Deprecated", true)>]
new System.Fabric.FabricClient : System.Fabric.SecurityCredentials * TimeSpan * string[] -> System.Fabric.FabricClient
Public Sub New (credential As SecurityCredentials, keepAliveInterval As TimeSpan, ParamArray hostEndpoints As String())

Parameter

credential
SecurityCredentials

Definieren der Sicherheitsanmeldeinformationen.

keepAliveInterval
TimeSpan

Definiert das periodische Keep Alive-Nachrichtenintervall.

hostEndpoints
String[]

Definiert den Satz von Gatewayadressen, die zum FabricClient Herstellen einer Verbindung mit dem Cluster verwendet werden können.

Attribute

Hinweise

Wenn zwischen der Verbindung zwischen dem Client und dem Cluster externe Geräte vorhanden sind, die regelmäßige Nachrichten erfordern, um die Verbindung aufrechtzuerhalten, sollten Sie unbedingt das KeepAlive-Feature von FabricClient verwenden. Während der Initialisierung von FabricClient können Benutzer einen TimeSpan-KeepAliveInterval angeben. Wenn dieses Argument angegeben ist, sendet der FabricClient regelmäßig einen Ping an den Service Fabric Gateway-Dienst, mit dem er derzeit kommuniziert, solange ein ausstehender Vorgang vorliegt. Ein Beispiel für ein Szenario, in dem dieses Feature nützlich ist, ist Windows Azure. Wenn sich der FabricClient außerhalb von Windows Azure befindet und sich der Cluster innerhalb von Windows Azure befindet, werden alle Verbindungen über die Azure Load Balancer (ALB) ausgeführt. ALB beendet Verbindungen, die sich mehr als 60 Sekunden im Leerlauf befinden. Daher sollte in diesen Situationen FabricClient mit KeepAliveInterval auf <59 Sekunden festgelegt werden (20 -30 wird empfohlen).

Gilt für: