你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
FabricClient.PropertyManagementClient.PutPropertyAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| PutPropertyAsync(Uri, String, Byte[]) |
在给定名称下创建或更新数组类型的 Byte 指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, Double) |
在给定名称下创建或更新类型 Double 为的指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, Guid) |
在给定名称下创建或更新类型 Guid 为的指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, Int64) |
在给定名称下创建或更新类型 Int64 为的指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, String) |
在给定名称下创建或更新类型 String 为的指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, Byte[], TimeSpan, CancellationToken) |
在给定名称下创建或更新数组类型的 Byte 指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, Double, TimeSpan, CancellationToken) |
在给定名称下创建或更新类型 Double 为的指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, Guid, TimeSpan, CancellationToken) |
在给定名称下创建或更新类型 Guid 为的指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, Int64, TimeSpan, CancellationToken) |
在给定名称下创建或更新类型 Int64 为的指定 Service Fabric 属性。 |
| PutPropertyAsync(Uri, String, String, TimeSpan, CancellationToken) |
在给定名称下创建或更新类型 String 为的指定 Service Fabric 属性。 |
PutPropertyAsync(Uri, String, Byte[])
在给定名称下创建或更新数组类型的 Byte 指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, byte[] value);member this.PutPropertyAsync : Uri * string * byte[] -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Byte()) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Byte[]
该属性的值。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 如果 parentName 不是有效的 Service Fabric 名称，则返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。
发生内部错误时会引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, Double)
在给定名称下创建或更新类型 Double 为的指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, double value);member this.PutPropertyAsync : Uri * string * double -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Double) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Double
该属性的值。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 如果 parentName 不是有效的 Service Fabric 名称，则返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。
发生内部错误时会引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, Guid)
在给定名称下创建或更新类型 Guid 为的指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, Guid value);member this.PutPropertyAsync : Uri * string * Guid -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Guid) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Guid
该属性的值。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 如果 parentName 不是有效的 Service Fabric 名称，则返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。
发生内部错误时会引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, Int64)
在给定名称下创建或更新类型 Int64 为的指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, long value);member this.PutPropertyAsync : Uri * string * int64 -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Long) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Int64
该属性的值。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 如果 parentName 不是有效的 Service Fabric 名称，则返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。
发生内部错误时会引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, String)
在给定名称下创建或更新类型 String 为的指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, string value);member this.PutPropertyAsync : Uri * string * string -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As String) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- String
该属性的值。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 如果 parentName 不是有效的 Service Fabric 名称，则返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。
发生内部错误时会引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, Byte[], TimeSpan, CancellationToken)
在给定名称下创建或更新数组类型的 Byte 指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, byte[] value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);member this.PutPropertyAsync : Uri * string * byte[] * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Byte(), timeout As TimeSpan, cancellationToken As CancellationToken) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Byte[]
该属性的值。
- timeout
- TimeSpan
在返回 TimeoutException之前，系统允许此操作继续的最长时间。
- cancellationToken
- CancellationToken
CancellationToken操作正在观测的 。 它可用于传播应取消操作的通知。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 如果 parentName 不是有效的 Service Fabric 名称，则返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。
发生内部错误时会引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, Double, TimeSpan, CancellationToken)
在给定名称下创建或更新类型 Double 为的指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, double value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);member this.PutPropertyAsync : Uri * string * double * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Double, timeout As TimeSpan, cancellationToken As CancellationToken) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Double
该属性的值。
- timeout
- TimeSpan
在返回 TimeoutException之前，系统允许此操作继续的最长时间。
- cancellationToken
- CancellationToken
CancellationToken操作正在观测的 。 它可用于传播应取消操作的通知。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 如果 parentName 不是有效的 Service Fabric 名称，则返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。
发生内部错误时会引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, Guid, TimeSpan, CancellationToken)
在给定名称下创建或更新类型的 Guid 指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, Guid value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);member this.PutPropertyAsync : Uri * string * Guid * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Guid, timeout As TimeSpan, cancellationToken As CancellationToken) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Guid
该属性的值。
- timeout
- TimeSpan
在返回 TimeoutException之前，系统允许此操作继续的最长时间。
- cancellationToken
- CancellationToken
CancellationToken操作正在观察的 。 它可用于传播应取消操作的通知。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 当 不是有效的 Service Fabric 名称时 parentName ，将返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见的 FabricClient 故障。
发生内部错误时，将引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, Int64, TimeSpan, CancellationToken)
在给定名称下创建或更新类型的 Int64 指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, long value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);member this.PutPropertyAsync : Uri * string * int64 * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As Long, timeout As TimeSpan, cancellationToken As CancellationToken) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- Int64
该属性的值。
- timeout
- TimeSpan
在返回 TimeoutException之前，系统允许此操作继续的最长时间。
- cancellationToken
- CancellationToken
CancellationToken操作正在观察的 。 它可用于传播应取消操作的通知。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 当 不是有效的 Service Fabric 名称时 parentName ，将返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见的 FabricClient 故障。
发生内部错误时，将引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
适用于
PutPropertyAsync(Uri, String, String, TimeSpan, CancellationToken)
在给定名称下创建或更新类型的 String 指定 Service Fabric 属性。
public System.Threading.Tasks.Task PutPropertyAsync (Uri parentName, string propertyName, string value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);member this.PutPropertyAsync : Uri * string * string * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function PutPropertyAsync (parentName As Uri, propertyName As String, value As String, timeout As TimeSpan, cancellationToken As CancellationToken) As Task参数
- parentName
- Uri
父 Service Fabric 名称。
- propertyName
- String
Service Fabric 属性的名称。
- value
- String
该属性的值。
- timeout
- TimeSpan
在返回 TimeoutException之前，系统允许此操作继续的最长时间。
- cancellationToken
- CancellationToken
正在观察操作。 它可用于传播应取消操作的通知。
返回
表示异步放置操作的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 。
由以下原因之一引起：
InvalidNameUri 当 不是有效的 Service Fabric 名称时 parentName ，将返回 。
ValueTooLarge 大于 1MB 时 value 返回 。
另 https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见的 FabricClient 故障。
发生内部错误时，将引发此异常。
注解
操作的超时将设置为默认超时 (1 分钟) 。
