IReliableStateManager.GetOrAddAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| GetOrAddAsync<T>(String) |
Obtient un IReliableState du type |
| GetOrAddAsync<T>(Uri) |
Obtient un IReliableState du type |
| GetOrAddAsync<T>(ITransaction, String) |
Obtient un IReliableState du type |
| GetOrAddAsync<T>(ITransaction, Uri) |
Obtient un IReliableState du type |
| GetOrAddAsync<T>(String, TimeSpan) |
Obtient un IReliableState du type |
| GetOrAddAsync<T>(Uri, TimeSpan) |
Obtient un IReliableState du type |
| GetOrAddAsync<T>(ITransaction, String, TimeSpan) |
Obtient un IReliableState du type |
| GetOrAddAsync<T>(ITransaction, Uri, TimeSpan) |
Obtient un IReliableState du type |
GetOrAddAsync<T>(String)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- name
- String
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
name a la valeur null.
Impossible de créer une instance du type T ou le instance existant IReliableState n’est pas de type T.
L’opération n’a pas pu se terminer dans le délai d’expiration par défaut.
Levée lorsque n’est IReliableStateManager pas dans Primary.
Indique que le Gestionnaire d’état fiable est fermé.
L’opération a été défaillante en interne par le système. Retentez l’opération
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé.
S’applique à
GetOrAddAsync<T>(Uri)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- name
- Uri
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
name a la valeur null.
Impossible de créer une instance du type T ou le instance existant IReliableState n’est pas de type T.
L’opération n’a pas pu se terminer dans le délai d’expiration par défaut.
Levée lorsque n’est IReliableStateManager pas dans Primary.
Indique que le Gestionnaire d’état fiable est fermé.
L’opération a été défaillante en interne par le système. Retentez l’opération
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé.
S’applique à
GetOrAddAsync<T>(ITransaction, String)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- name
- String
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
tx a la valeur null ou name a la valeur Null.
Impossible de créer une instance du type T ou le instance existant IReliableState n’est pas de type T.
L’opération n’a pas pu se terminer dans le délai d’expiration par défaut.
Levée lorsque n’est IReliableStateManager pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est très probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le Gestionnaire d’état fiable est fermé.
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé. Si cette méthode lève une exception, la transaction doit être abandonnée.
S’applique à
GetOrAddAsync<T>(ITransaction, Uri)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- name
- Uri
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
tx a la valeur null ou name a la valeur Null.
Impossible de créer une instance du type T ou le instance existant IReliableState n’est pas de type T.
L’opération n’a pas pu se terminer dans le délai d’expiration par défaut.
Levée lorsque n’est IReliableStateManager pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est très probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le Gestionnaire d’état fiable est fermé.
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé. Si cette méthode lève une exception, la transaction doit être abandonnée.
S’applique à
GetOrAddAsync<T>(String, TimeSpan)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- name
- String
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
- timeout
- TimeSpan
Délai d’attente de la fin de l’opération avant de lever une exception TimeoutException. Principalement utilisé pour éviter les interblocages. La valeur par défaut est de 4 secondes.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
name a la valeur null.
Une instance du type T ne peut pas être créée, ou la instance existante IReliableState n’est pas de type Tou timeout est négative.
L’opération n’a pas pu se terminer dans le délai d’expiration donné.
Levée lorsque n’est IReliableStateManager pas dans Primary.
Indique que le Gestionnaire d’état fiable est fermé.
L’opération a été défaillante en interne par le système. Retentez l’opération
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé.
S’applique à
GetOrAddAsync<T>(Uri, TimeSpan)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- name
- Uri
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
- timeout
- TimeSpan
Délai d’attente de la fin de l’opération avant de lever une exception TimeoutException. Principalement utilisé pour éviter les interblocages. La valeur par défaut est de 4 secondes.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
name a la valeur null.
Une instance du type T ne peut pas être créée, ou la instance existante IReliableState n’est pas de type Tou timeout est négative.
L’opération n’a pas pu se terminer dans le délai d’expiration donné.
Levée lorsque n’est IReliableStateManager pas dans Primary.
Indique que le Gestionnaire d’état fiable est fermé.
L’opération a été défaillante en interne par le système. Retentez l’opération
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé.
S’applique à
GetOrAddAsync<T>(ITransaction, String, TimeSpan)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- name
- String
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
- timeout
- TimeSpan
Délai d’attente de la fin de l’opération avant de lever une exception TimeoutException. Principalement utilisé pour éviter les interblocages. La valeur par défaut est de 4 secondes.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
tx a la valeur null ou name a la valeur Null.
Une instance du type T ne peut pas être créée, ou la instance existante IReliableState n’est pas de type Tou timeout est négative.
L’opération n’a pas pu se terminer dans le délai d’expiration donné.
Levée lorsque n’est IReliableStateManager pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est très probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le Gestionnaire d’état fiable est fermé.
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé. Si cette méthode lève une exception, la transaction doit être abandonnée.
S’applique à
GetOrAddAsync<T>(ITransaction, Uri, TimeSpan)
Obtient un IReliableState du type T donné et avec le nom donné s’il existe, ou en crée un et le retourne s’il n’existe pas déjà.
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)Paramètres de type
- T
Lorsque vous spécifiez le IReliableState type, vous pouvez demander un type de classe ou un type d’interface.
Si vous spécifiez un type de classe, le système tente de retourner une instance de ce type. Si une instance de ce type ne peut pas être instanciée (par exemple, une classe abstraite, aucun constructeur approprié), une exception ArgumentException est levée.
Si vous spécifiez un type d’interface, le responsable tente de résoudre l’interface en un type concret. Si le mappage de type est spécifié par l’utilisateur, cette méthode utilise le mappage spécifié par l’utilisateur pour résoudre le type (non encore pris en charge). Si le mappage de type n’est pas spécifié par l’utilisateur, cette méthode sélectionne l’implémentation par défaut pour l’interface donnée. Si le type d’interface donné n’a pas d’implémentation par défaut, si un mappage spécifié par l’utilisateur pour le type n’est pas fourni ou si le type n’est pas valide, cette méthode lève ArgumentException.
Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- name
- Uri
Nom de l'objet IReliableState. Ce nom doit être unique dans tous IReliableStateManager les IReliableState types, y compris les types non liés.
- timeout
- TimeSpan
Délai d’attente de la fin de l’opération avant de lever une exception TimeoutException. Principalement utilisé pour éviter les interblocages. La valeur par défaut est de 4 secondes.
Retours
Tâche qui représente l’opération asynchrone. Le résultat de la tâche est l’état fiable instance.
Exceptions
tx a la valeur null ou name a la valeur Null.
Une instance du type T ne peut pas être créée, ou la instance existante IReliableState n’est pas de type Tou timeout est négative.
L’opération n’a pas pu se terminer dans le délai d’expiration donné.
Levée lorsque n’est IReliableStateManager pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est très probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le Gestionnaire d’état fiable est fermé.
Remarques
Il s’agit d’une opération atomique. Lorsqu’un IReliableState doit être créé, il est terminé et retourné correctement ou il ne sera pas créé. Si cette méthode lève une exception, la transaction doit être abandonnée.
S’applique à
Azure SDK for .NET