Partager via

Grain Classe

  • Référence

Définition

Espace de noms:
Orleans
Assembly:
Orleans.dll
Assembly:
Orleans.Core.Abstractions.dll
Paquet:
Microsoft.Orleans.Core v1.5.10
Paquet:
Microsoft.Orleans.Core.Abstractions v2.4.5
Paquet:
Microsoft.Orleans.Core.Abstractions v3.6.5
Paquet:
Microsoft.Orleans.Core.Abstractions v7.2.5
Paquet:
Microsoft.Orleans.Core.Abstractions v8.0.0
Paquet:
Microsoft.Orleans.Core.Abstractions v8.1.0
Paquet:
Microsoft.Orleans.Core.Abstractions v8.2.0
Source:
Grain.cs

Classe de base abstraite pour toutes les classes de grain.

public abstract class Grain : Orleans.Runtime.IAddressable
public abstract class Grain : Orleans.ILifecycleParticipant<Orleans.Runtime.IGrainLifecycle>, Orleans.Runtime.IAddressable
public abstract class Grain : Orleans.IGrainBase, Orleans.Runtime.IAddressable
type Grain = class
    interface IAddressable
type Grain = class
    interface IAddressable
    interface ILifecycleParticipant<IGrainLifecycle>
type Grain = class
    interface IGrainBase
    interface IAddressable
Public MustInherit Class Grain
Implements IAddressable
Public MustInherit Class Grain
Implements IAddressable, ILifecycleParticipant(Of IGrainLifecycle)
Public MustInherit Class Grain
Implements IAddressable, IGrainBase
Héritage
Object
Grain
Dérivé
Implémente
IAddressable ILifecycleParticipant<IGrainLifecycle> IGrainBase

Constructeurs

Grain()

Ce constructeur ne doit jamais être appelé. Nous l’exposons afin que le code client (sous-classes de Grain) n’ait pas besoin d’ajouter un constructeur. Le code client doit utiliser la propriété GrainFactory pour obtenir une référence à un grain.
Grain(IGrainContext, IGrainRuntime)

Les implémenteurs de grain n’ont pas besoin d’exposer ce constructeur, mais peuvent choisir de le faire. Ce constructeur est particulièrement utile pour les tests unitaires où le code de test peut créer un grain et remplacer IGrainIdentity et IGrainRuntime par des doubles de test (fictives/stubs).
Grain(IGrainIdentity, IGrainRuntime)

Les implémenteurs de grain n’ont pas besoin d’exposer ce constructeur, mais peuvent choisir de le faire. Ce constructeur est particulièrement utile pour les tests unitaires où le code de test peut créer un grain et remplacer IGrainIdentity et IGrainRuntime par des doubles de test (fictives/stubs).

Propriétés

GrainContext

Classe de base abstraite pour toutes les classes de grain.
GrainFactory

Obtient un objet qui peut être utilisé pour accéder à d’autres grains. Null si ce grain n’est pas associé à un runtime, par exemple lorsqu’il est créé directement pour les tests unitaires.
GrainReference

Classe de base abstraite pour toutes les classes de grain.
IdentityString

Représentation sous forme de chaîne du SiloIdentity du grain, y compris le type et la clé primaire.
RuntimeIdentity

Identificateur unique du silo actuel. Il n’existe aucun contenu sémantique pour cette chaîne, mais il peut être utile pour la journalisation.
ServiceProvider

Obtient l’IServiceProvider géré par le runtime. Null si ce grain n’est pas associé à un runtime, par exemple lorsqu’il est créé directement pour les tests unitaires.

Méthodes

DeactivateOnIdle()

Désactivez cette activation du grain une fois l’appel de la méthode graine en cours terminé. Cet appel marque cette activation du grain actuel à désactiver et à supprimer à la fin de la méthode actuelle. L’appel suivant à ce grain entraînera une activation différente à utiliser, ce qui signifie généralement qu’une nouvelle activation sera créée automatiquement par le runtime.
DelayDeactivation(TimeSpan)

Retarder la désactivation de cette activation au moins pendant la durée spécifiée. Une valeur timeSpan positive signifie « empêcher gc de cette activation pour cette période ». Une valeur timeSpan négative signifie « annuler le paramètre précédent de l’appel DelayDeactivation et faire en sorte que cette activation se comporte en fonction des paramètres de garbage collection d’activation standard ». La méthode DeactivateOnIdle annule / remplace tout paramètre actuel « conserver actif », ce qui rend ce grain immédiatement disponible pour la désactivation.
GetLogger()

Retourne un objet enregistreur d’événements que le code de ce grain peut utiliser pour le suivi. Le nom de l’enregistreur d’événements est dérivé du nom de la classe de grain.
GetLogger(String)

Retourne un objet enregistreur d’événements que le code de ce grain peut utiliser pour le suivi.
GetReminder(String)

Retourne un rappel précédemment inscrit.
GetReminders()

Retourne la liste de tous les rappels inscrits par le grain.
GetStreamProvider(String)

Classe de base abstraite pour toutes les classes de grain.
GetStreamProviders()

Classe de base abstraite pour toutes les classes de grain.
MigrateOnIdle()

Démarre une tentative de migration de cette instance vers un autre emplacement. La migration capture le RequestContextactuel, le rendant disponible pour le directeur de placement de l’activation afin qu’il puisse le prendre en compte lors de la sélection d’un nouvel emplacement. La migration se produit de manière asynchrone, quand aucune demande n’est en cours d’exécution et ne se produit pas si le directeur de placement de l’activation ne sélectionne pas d’autre emplacement.
OnActivateAsync()

Cette méthode est appelée à la fin du processus d’activation d’un grain. Il est appelé avant que les messages aient été envoyés au grain. Pour les grains avec un état persistant déclaré, cette méthode est appelée après le remplissage de la propriété State.
OnActivateAsync(CancellationToken)

Cette méthode est appelée à la fin du processus d’activation d’un grain. Il est appelé avant que les messages aient été envoyés au grain. Pour les grains avec un état persistant déclaré, cette méthode est appelée après le remplissage de la propriété State.
OnDeactivateAsync()

Cette méthode est appelée au début du processus de désactivation d’un grain.
OnDeactivateAsync(DeactivationReason, CancellationToken)

Cette méthode est appelée au début du processus de désactivation d’un grain.
Participate(IGrainLifecycle)

Classe de base abstraite pour toutes les classes de grain.
RegisterOrUpdateReminder(String, TimeSpan, TimeSpan)

Inscrit un rappel persistant et fiable pour envoyer des notifications régulières (rappels) au grain. Le grain doit implémenter l’interface Orleans.IRemindable, et les rappels pour ce grain seront envoyés à la méthode de rappel ReceiveReminder. Si le grain actuel est désactivé lorsque le minuteur se déclenche, une nouvelle activation de ce grain est créée pour recevoir ce rappel. Si un rappel existant portant le même nom existe déjà, ce rappel sera remplacé par ce nouveau rappel. Les rappels seront toujours reçus par une activation de ce grain, même si plusieurs activations existent pour ce grain.
RegisterTimer(Func<Object,Task>, Object, TimeSpan, TimeSpan)
Obsolète.

Inscrit un minuteur pour envoyer des rappels périodiques à ce grain.
UnregisterReminder(IGrainReminder)

Annule l’inscription d’un rappel précédemment inscrit.

Implémentations d’interfaces explicites

IGrainBase.GrainContext

Classe de base abstraite pour toutes les classes de grain.

Méthodes d’extension

DeactivateOnIdle(IGrainBase)

Désactivez cette activation de grain une fois l’appel de la méthode graine en cours terminé. Cet appel marque cette activation du grain actuel à désactiver et à supprimer à la fin de la méthode actuelle. L’appel suivant à ce grain entraînera une activation différente à utiliser, ce qui signifie généralement qu’une nouvelle activation sera créée automatiquement par le runtime.
MigrateOnIdle(IGrainBase)

Démarre une tentative de migration de cette instance vers un autre emplacement. La migration capture le RequestContextactuel, le rendant disponible pour le directeur de placement de l’activation afin qu’il puisse le prendre en compte lors de la sélection d’un nouvel emplacement. La migration se produit de manière asynchrone, quand aucune demande n’est en cours d’exécution et ne se produit pas si le directeur de placement de l’activation ne sélectionne pas d’autre emplacement.
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, GrainTimerCreationOptions)

Crée un minuteur de grain.
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, TimeSpan, TimeSpan)

Crée un minuteur de grain.
RegisterGrainTimer(IGrainBase, Func<Task>, GrainTimerCreationOptions)

Classe de base abstraite pour toutes les classes de grain.
RegisterGrainTimer(IGrainBase, Func<Task>, TimeSpan, TimeSpan)

Crée un minuteur de grain.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, GrainTimerCreationOptions)

Crée un minuteur de grain.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, TimeSpan, TimeSpan)

Crée un minuteur de grain.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, GrainTimerCreationOptions)

Classe de base abstraite pour toutes les classes de grain.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, TimeSpan, TimeSpan)

Crée un minuteur de grain.
AsReference(IAddressable, Type)

Retourne une référence typée au grain fourni.
AsReference<TGrainInterface>(IAddressable)

Retourne une référence typée au grain fourni.
BindGrainReference(IAddressable, IGrainFactory)

Lie la référence de grain au IGrainFactoryfourni.
Cast(IAddressable, Type)

Retourne une référence typée au grain fourni.
Cast<TGrainInterface>(IAddressable)

Retourne une référence typée au grain fourni.
GetGrainId(IAddressable)

Retourne l’ID de grain correspondant au grain fourni.
GetPrimaryKey(IAddressable)

Retourne la représentation Guid d’une clé primaire de grain.
GetPrimaryKey(IAddressable, String)

Retourne la représentation Guid d’une clé primaire de grain.
GetPrimaryKeyLong(IAddressable)

Retourne la représentation long d’une clé primaire de grain.
GetPrimaryKeyLong(IAddressable, String)

Retourne la représentation long d’une clé primaire de grain.
GetPrimaryKeyString(IAddressable)

Retourne la string clé primaire du grain.
IsPrimaryKeyBasedOnLong(IAddressable)

Retourne si une partie de la clé primaire est de type long.
GetReminder(Grain, String)

Retourne un rappel précédemment inscrit.
GetReminder(IGrainBase, String)

Retourne un rappel précédemment inscrit.
GetReminders(Grain)

Retourne la liste de tous les rappels inscrits par le grain.
GetReminders(IGrainBase)

Retourne la liste de tous les rappels inscrits par le grain.
RegisterOrUpdateReminder(Grain, String, TimeSpan, TimeSpan)

Inscrit un rappel persistant et fiable pour envoyer des notifications régulières (rappels) au grain. Le grain doit implémenter l’interface Orleans.IRemindable, et les rappels pour ce grain seront envoyés à la méthode de rappel ReceiveReminder. Si le grain actuel est désactivé lorsque le minuteur se déclenche, une nouvelle activation de ce grain est créée pour recevoir ce rappel. Si un rappel existant portant le même nom existe déjà, ce rappel sera remplacé par ce nouveau rappel. Les rappels seront toujours reçus par une activation de ce grain, même si plusieurs activations existent pour ce grain.
RegisterOrUpdateReminder(IGrainBase, String, TimeSpan, TimeSpan)

Inscrit un rappel persistant et fiable pour envoyer des notifications régulières (rappels) au grain. Le grain doit implémenter l’interface Orleans.IRemindable, et les rappels pour ce grain seront envoyés à la méthode de rappel ReceiveReminder. Si le grain actuel est désactivé lorsque le minuteur se déclenche, une nouvelle activation de ce grain est créée pour recevoir ce rappel. Si un rappel existant portant le même nom existe déjà, ce rappel sera remplacé par ce nouveau rappel. Les rappels seront toujours reçus par une activation de ce grain, même si plusieurs activations existent pour ce grain.
UnregisterReminder(Grain, IGrainReminder)

Annule l’inscription d’un rappel précédemment inscrit.
UnregisterReminder(IGrainBase, IGrainReminder)

Annule l’inscription d’un rappel précédemment inscrit.
GetStreamProvider(Grain, String)

Obtient le fournisseur de flux avec le namespécifié.
GetStreamProvider(IGrainBase, String)

Obtient le fournisseur de flux avec le namespécifié.
GetLogger(Grain)

Retourne un objet enregistreur d’événements que le code de ce grain peut utiliser pour le suivi. Le nom de l’enregistreur d’événements est dérivé du nom de la classe de grain.
GetLogger(Grain, String)

Retourne un objet enregistreur d’événements que le code de ce grain peut utiliser pour le suivi.
GetGrainStorage(Grain, IServiceProvider)

Acquérir le fournisseur de stockage associé au type de grain.

S’applique à