你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

FabricClient.ServiceManagementClient.CreateServiceFromTemplateAsync 方法

定义

命名空间:

System.Fabric

程序集:

System.Fabric.dll

包:

Microsoft.ServiceFabric v9.1.1833

重载

CreateServiceFromTemplateAsync(ServiceFromTemplateDescription)	从应用程序清单中指定的模板实例化服务。
CreateServiceFromTemplateAsync(ServiceFromTemplateDescription, TimeSpan, CancellationToken)	从应用程序清单中指定的模板实例化服务。
CreateServiceFromTemplateAsync(Uri, Uri, String, Byte[])	从应用程序清单中指定的模板实例化服务。
CreateServiceFromTemplateAsync(Uri, Uri, String, Byte[], TimeSpan, CancellationToken)	从应用程序清单中指定的模板实例化服务。 还采用超时间隔，这是系统允许此操作在返回 TimeoutException 和操作观察到的取消标记之前继续的最长时间。

CreateServiceFromTemplateAsync(ServiceFromTemplateDescription)

从应用程序清单中指定的模板实例化服务。

public System.Threading.Tasks.Task CreateServiceFromTemplateAsync (System.Fabric.Description.ServiceFromTemplateDescription serviceFromTemplateDescription);

member this.CreateServiceFromTemplateAsync : System.Fabric.Description.ServiceFromTemplateDescription -> System.Threading.Tasks.Task

Public Function CreateServiceFromTemplateAsync (serviceFromTemplateDescription As ServiceFromTemplateDescription) As Task

参数

serviceFromTemplateDescription

ServiceFromTemplateDescription

描述要从应用程序清单中指定的服务模板创建的服务。

返回

Task

实例化服务。

例外

FabricObjectClosedException

对象 FabricClient 处于关闭状态。 释放正在使用的对象 FabricClient 并实例化新 FabricClient 对象。

FabricElementNotFoundException

ServiceTemplateNotFound：服务模板不存在。

TimeoutException

请求已超时，但系统可能已接受处理。

OperationCanceledException

请求在超时到期前已取消，但系统可能已接受处理请求。

注解

如果 Service Fabric 名称尚不存在，则会隐式创建它。

CreateServiceFromTemplateAsync(ServiceFromTemplateDescription, TimeSpan, CancellationToken)

从应用程序清单中指定的模板实例化服务。

public System.Threading.Tasks.Task CreateServiceFromTemplateAsync (System.Fabric.Description.ServiceFromTemplateDescription serviceFromTemplateDescription, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.CreateServiceFromTemplateAsync : System.Fabric.Description.ServiceFromTemplateDescription * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function CreateServiceFromTemplateAsync (serviceFromTemplateDescription As ServiceFromTemplateDescription, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

参数

serviceFromTemplateDescription

ServiceFromTemplateDescription

描述要从应用程序清单中指定的服务模板创建的服务。

timeout

TimeSpan

在返回 TimeoutException之前，系统允许此操作继续的最长时间。

cancellationToken

CancellationToken

CancellationToken操作正在观测的 。 它可用于传播应取消操作的通知。

返回

Task

实例化服务。

例外

FabricObjectClosedException

对象 FabricClient 处于关闭状态。 释放正在使用的对象 FabricClient 并实例化新 FabricClient 对象。

FabricElementNotFoundException

ServiceTemplateNotFound：服务模板不存在。

TimeoutException

请求已超时，但系统可能已接受处理。

OperationCanceledException

请求在超时到期前已取消，但系统可能已接受处理请求。

注解

如果 Service Fabric 名称尚不存在，则会隐式创建它。

CreateServiceFromTemplateAsync(Uri, Uri, String, Byte[])

从应用程序清单中指定的模板实例化服务。

public System.Threading.Tasks.Task CreateServiceFromTemplateAsync (Uri applicationName, Uri serviceName, string serviceTypeName, byte[] initializationData);

member this.CreateServiceFromTemplateAsync : Uri * Uri * string * byte[] -> System.Threading.Tasks.Task

Public Function CreateServiceFromTemplateAsync (applicationName As Uri, serviceName As Uri, serviceTypeName As String, initializationData As Byte()) As Task

参数

applicationName

Uri

要在其中创建服务的应用程序的 Service Fabric 名称。

serviceName

Uri

服务的 Service Fabric 名称。

serviceTypeName

String

服务类型的名称。 这必须与服务清单中指定的 ServiceTypeName 相同。

initializationData

Byte[]

初始化数据表示服务创建者提供的自定义数据。 Service Fabric 不分析此数据。 此数据将在 或 中的每个实例或副本 (replica) 中StatefulServiceContextStatelessServiceContext可用。 创建服务后无法更改它。

返回

Task

实例化服务。

例外

FabricObjectClosedException

对象 FabricClient 处于关闭状态。 释放正在使用的对象 FabricClient 并实例化新 FabricClient 对象。

FabricElementNotFoundException

ServiceTemplateNotFound：服务模板不存在

TimeoutException

请求已超时，但系统可能已接受处理。

OperationCanceledException

请求在超时到期前已取消，但系统可能已接受处理请求。

ArgumentNullException

当 applicationName 或 serviceName 为 null 时。

ArgumentException

当 serviceTypeName 为 null 或空格时。

注解

如果 Service Fabric 名称尚不存在，则会隐式创建它。

默认超时为一分钟，系统将在返回 TimeoutException之前允许此操作继续。

CreateServiceFromTemplateAsync(Uri, Uri, String, Byte[], TimeSpan, CancellationToken)

从应用程序清单中指定的模板实例化服务。 还采用超时间隔，这是系统允许此操作在返回 TimeoutException 和操作观察到的取消标记之前继续的最长时间。

public System.Threading.Tasks.Task CreateServiceFromTemplateAsync (Uri applicationName, Uri serviceName, string serviceTypeName, byte[] initializationData, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.CreateServiceFromTemplateAsync : Uri * Uri * string * byte[] * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function CreateServiceFromTemplateAsync (applicationName As Uri, serviceName As Uri, serviceTypeName As String, initializationData As Byte(), timeout As TimeSpan, cancellationToken As CancellationToken) As Task

参数

applicationName

Uri

要在其中创建服务的应用程序的 Service Fabric 名称。

serviceName

Uri

服务的 Service Fabric 名称。

serviceTypeName

String

服务类型的名称。 这必须与服务清单中指定的 ServiceTypeName 相同。

initializationData

Byte[]

初始化数据表示服务创建者提供的自定义数据。 Service Fabric 不分析此数据。 此数据将在 或 中的每个实例或副本 (replica) 中StatefulServiceContextStatelessServiceContext可用。 创建服务后无法更改它。

timeout

TimeSpan

在返回 TimeoutException之前，系统允许此操作继续的最长时间。

cancellationToken

CancellationToken

CancellationToken操作正在观测的 。 它可用于传播应取消操作的通知。

返回

Task

实例化服务。

例外

FabricObjectClosedException

对象 FabricClient 处于关闭状态。 释放正在使用的对象 FabricClient 并实例化新 FabricClient 对象。

FabricElementNotFoundException

ServiceTemplateNotFound：服务模板不存在。

TimeoutException

请求已超时，但系统可能已接受处理。

OperationCanceledException

请求在超时到期前已取消，但系统可能已接受处理请求。

ArgumentNullException

当 applicationName 或 serviceName 为 null 时。

ArgumentException

当 serviceTypeName 为 null 或空格时。

注解

如果 Service Fabric 名称尚不存在，则会隐式创建它。