IReliableStateManager.GetOrAddAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| GetOrAddAsync<T>(String) |
Obtém um IReliableState do tipo |
| GetOrAddAsync<T>(Uri) |
Obtém um IReliableState do tipo |
| GetOrAddAsync<T>(ITransaction, String) |
Obtém um IReliableState do tipo |
| GetOrAddAsync<T>(ITransaction, Uri) |
Obtém um IReliableState do tipo |
| GetOrAddAsync<T>(String, TimeSpan) |
Obtém um IReliableState do tipo |
| GetOrAddAsync<T>(Uri, TimeSpan) |
Obtém um IReliableState do tipo |
| GetOrAddAsync<T>(ITransaction, String, TimeSpan) |
Obtém um IReliableState do tipo |
| GetOrAddAsync<T>(ITransaction, Uri, TimeSpan) |
Obtém um IReliableState do tipo |
GetOrAddAsync<T>(String)
Obtém um IReliableState do tipo T especificado e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (string name) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : string -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (name As String) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerente tentará resolve a interface para um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda não compatível). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- name
- String
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo T.
A operação não foi concluída dentro do tempo limite padrão.
Gerado quando o IReliableStateManager não está em Primary.
Indica que o Gerenciador de Estado Confiável está fechado.
A operação foi falha interna do sistema. Repita a operação
Comentários
Esta é uma operação atômica. Quando um IReliableState precisar ser criado, ele será concluído e retornará com êxito ou não será criado.
Aplica-se a
GetOrAddAsync<T>(Uri)
Obtém um IReliableState do tipo T especificado e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Uri name) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : Uri -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (name As Uri) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerente tentará resolve a interface para um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda não compatível). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- name
- Uri
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo T.
A operação não foi concluída dentro do tempo limite padrão.
Gerado quando o IReliableStateManager não está em Primary.
Indica que o Gerenciador de Estado Confiável está fechado.
A operação foi falha interna do sistema. Repita a operação
Comentários
Esta é uma operação atômica. Quando um IReliableState precisar ser criado, ele será concluído e retornará com êxito ou não será criado.
Aplica-se a
GetOrAddAsync<T>(ITransaction, String)
Obtém um IReliableState do tipo T especificado e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, string name) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * string -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As String) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerente tentará resolve a interface para um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda não compatível). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- name
- String
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
tx é nulo ou name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo T.
A operação não foi concluída dentro do tempo limite padrão.
Gerado quando o IReliableStateManager não está em Primary.
A transação foi falha interna do sistema. Repetir a operação em uma nova transação
Gerado quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.
Indica que o Gerenciador de Estado Confiável está fechado.
Comentários
Esta é uma operação atômica. Quando um IReliableState precisar ser criado, ele será concluído e retornará com êxito ou não será criado. Se esse método gerar uma exceção, a transação deverá ser anulada.
Aplica-se a
GetOrAddAsync<T>(ITransaction, Uri)
Obtém um IReliableState do tipo T fornecido e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, Uri name) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * Uri -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As Uri) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerenciador tentará resolve a interface a um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda sem suporte). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- name
- Uri
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
tx é nulo ou name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo T.
A operação não foi concluída dentro do tempo limite padrão.
Gerado quando o IReliableStateManager não está em Primary.
A transação foi falha interna do sistema. Repetir a operação em uma nova transação
Gerado quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.
Indica que o Gerenciador de Estado Confiável está fechado.
Comentários
Esta é uma operação atômica. Quando um IReliableState precisar ser criado, ele será concluído e retornará com êxito ou não será criado. Se esse método gerar uma exceção, a transação deverá ser anulada.
Aplica-se a
GetOrAddAsync<T>(String, TimeSpan)
Obtém um IReliableState do tipo T fornecido e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (string name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : string * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (name As String, timeout As TimeSpan) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerenciador tentará resolve a interface a um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda sem suporte). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- name
- String
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
- timeout
- TimeSpan
A quantidade de tempo para aguardar a conclusão da operação antes de lançar um TimeoutException. Usado principalmente para evitar deadlocks. O padrão é 4 segundos.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo Tou timeout é negativa.
Falha ao concluir a operação dentro do tempo limite especificado.
Gerado quando o IReliableStateManager não está em Primary.
Indica que o Gerenciador de Estado Confiável está fechado.
A operação foi falha interna pelo sistema. Repita a operação
Comentários
Esta é uma operação atômica. Quando um IReliableState precisa ser criado, ele será concluído e retornado com êxito ou não será criado.
Aplica-se a
GetOrAddAsync<T>(Uri, TimeSpan)
Obtém um IReliableState do tipo T fornecido e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Uri name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : Uri * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (name As Uri, timeout As TimeSpan) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerenciador tentará resolve a interface a um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda sem suporte). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- name
- Uri
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
- timeout
- TimeSpan
A quantidade de tempo para aguardar a conclusão da operação antes de lançar um TimeoutException. Usado principalmente para evitar deadlocks. O padrão é 4 segundos.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo Tou timeout é negativa.
Falha ao concluir a operação dentro do tempo limite especificado.
Gerado quando o IReliableStateManager não está em Primary.
Indica que o Gerenciador de Estado Confiável está fechado.
A operação foi falha interna pelo sistema. Repita a operação
Comentários
Esta é uma operação atômica. Quando um IReliableState precisa ser criado, ele será concluído e retornado com êxito ou não será criado.
Aplica-se a
GetOrAddAsync<T>(ITransaction, String, TimeSpan)
Obtém um IReliableState do tipo T fornecido e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, string name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * string * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As String, timeout As TimeSpan) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerenciador tentará resolve a interface a um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda sem suporte). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- name
- String
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
- timeout
- TimeSpan
A quantidade de tempo para aguardar a conclusão da operação antes de lançar um TimeoutException. Usado principalmente para evitar deadlocks. O padrão é 4 segundos.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
tx é nulo ou name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo Tou timeout é negativa.
Falha ao concluir a operação dentro do tempo limite especificado.
Gerado quando o IReliableStateManager não está em Primary.
A transação foi falha interna pelo sistema. Repetir a operação em uma nova transação
Gerada quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.
Indica que o Gerenciador de Estado Confiável está fechado.
Comentários
Esta é uma operação atômica. Quando um IReliableState precisa ser criado, ele será concluído e retornado com êxito ou não será criado. Se esse método gerar uma exceção, a transação deverá ser anulada.
Aplica-se a
GetOrAddAsync<T>(ITransaction, Uri, TimeSpan)
Obtém um IReliableState do tipo T especificado e com o nome fornecido, se ele existir, ou cria um e o retorna se ele ainda não existir.
public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, Uri name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * Uri * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As Uri, timeout As TimeSpan) As Task(Of T)Parâmetros de tipo
- T
Ao especificar o IReliableState tipo, você pode solicitar um tipo de classe ou um tipo de interface.
Se especificar um tipo de classe, o sistema tentará retornar uma instância desse tipo. Se uma instância desse tipo não puder ser instanciada (por exemplo, classe abstrata, nenhum construtor adequado), uma ArgumentException será gerada.
Se especificar um tipo de interface, o gerente tentará resolve a interface para um tipo concreto. Se o mapeamento de tipo for especificado pelo usuário, esse método usará o mapeamento especificado pelo usuário para resolve o tipo (ainda não compatível). Se o mapeamento de tipo não for especificado pelo usuário, esse método selecionará a implementação padrão para a interface fornecida. Se o tipo de interface fornecido não tiver uma implementação padrão ou um mapeamento especificado pelo usuário para o tipo não for fornecido ou o tipo for inválido, esse método gerará ArgumentException.
Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- name
- Uri
O nome do IReliableState. Esse nome deve ser exclusivo nesse tipo IReliableStateManagerIReliableState , incluindo tipos não relacionados.
- timeout
- TimeSpan
A quantidade de tempo para aguardar a conclusão da operação antes de lançar um TimeoutException. Usado principalmente para evitar deadlocks. O padrão é 4 segundos.
Retornos
Tarefa que representa a operação assíncrona. O resultado da tarefa é a instância de estado confiável.
Exceções
tx é nulo ou name é nulo.
Uma instância do tipo T não pode ser criada ou a instância existente IReliableState não é do tipo Tou timeout é negativa.
Falha ao concluir a operação dentro do tempo limite especificado.
Gerado quando o IReliableStateManager não está em Primary.
A transação foi falha interna pelo sistema. Repetir a operação em uma nova transação
Gerada quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.
Indica que o Gerenciador de Estado Confiável está fechado.
Comentários
Esta é uma operação atômica. Quando um IReliableState precisar ser criado, ele será concluído e retornará com êxito ou não será criado. Se esse método gerar uma exceção, a transação deverá ser anulada.
Aplica-se a
Azure SDK for .NET
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários