Partilhar via


IReliableStateManager.GetOrAddAsync Método

Definição

Sobrecargas

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.

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.

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.

GetOrAddAsync<T>(ITransaction, 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.

GetOrAddAsync<T>(String, 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.

GetOrAddAsync<T>(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.

GetOrAddAsync<T>(ITransaction, String, 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.

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.

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

Task<T>

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.

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

Task<T>

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.

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

Task<T>

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.

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

Task<T>

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.

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

Task<T>

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.

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

Task<T>

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.

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

Task<T>

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.

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

Task<T>

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.

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