Partager via

TeamFoundationRequestContext, classe

  • Article

Toutes les demandes d'une Application Team Foundation créent TeamFoundationRequestContext et le contexte dans l'application ou une des classes de base d'infrastructure.

Hiérarchie d'héritage

System.Object
  Microsoft.TeamFoundation.Framework.Server.RequestContextBase
    Microsoft.TeamFoundation.Framework.Server.TeamFoundationRequestContext

Espace de noms :  Microsoft.TeamFoundation.Framework.Server
Assembly :  Microsoft.TeamFoundation.Framework.Server (dans Microsoft.TeamFoundation.Framework.Server.dll)

Syntaxe

'Déclaration
Public Class TeamFoundationRequestContext _
    Inherits RequestContextBase

public class TeamFoundationRequestContext : RequestContextBase

Le type TeamFoundationRequestContext expose les membres suivants.

Propriétés

  Nom Description
Propriété publique ActivityId L'ID d'activité du thread utilisé pour créer ce contexte de la requête.
Propriété publique AuthenticatedUserName Cela donne le nom d'utilisateur qui effectue la demande.S'il n'existait pas un utilisateur authentifié le nom d'utilisateur est retourné comme vide.
Propriété publique AuthenticationType Cela donne le type d'authentification de la demande (par exemple.Base, fédéré).
Propriété publique Command C'est une chaîne fournie par le client qui définit l'intention de l'ordre de l'utilisateur.Par exemple, si vous effectuez un get, vous envoyez la commande = get pour tous les téléchargements et appels d'UpdateLocalVersion.Cela vous permet des appels de regrouper déterminer les appels associés à une action utilisateur.
Propriété publique ContextId C'est un identificateur unique assigné à chaque RequestContextBase lorsqu'il est créé.Cet identificateur n'est jamais modifiée dans toute l'exécution de requête. (Hérité de RequestContextBase.)
Propriété publique DomainUserName Cela ne doit pas être utilisé.Il est uniquement ici pour autoriser le backcompat des services existants.
Propriété publique EndTime C'est le moment où la demande est terminé.Si la demande est encore active, EndTime sera égale à DateTime.MinValue.
Propriété publique ExecutionEnvironment
Propriété publique IsServicingContext Obtient une valeur indiquant si ce contexte de la requête est utilisé dans un contexte de service.
Propriété publique IsSystemContext Renvoie True lorsque le contexte est exécuté dans le cadre d'une requête de système et pas associé à un client.
Propriété publique IsTracked Si suivre les performances de cette demande (Hérité de RequestContextBase.)
Propriété publique IsUserContext Obtient une valeur indiquant si ce contexte de la requête est utilisé comme contexte utilisateur.
Propriété publique Items Un conteneur des propriétés pour le stockage des éléments dans le contexte de la requête.Les mots qui commencent par « $ » sont réservés.
Propriété publique Method Extraire les informations de méthode pour cette requête.Si la méthode n'a pas été démarré, ou ce n'est pas une méthode Web, il retourne null.
Propriété publique Queued Une demande en file d'attente est une application qui ne traite pas actuellement.Cela signifie que son étant géré pour une raison ou une autre, par exemple, le serveur est trop occupé et contient la demande jusqu'à ce que la charge éclaire.
Propriété publique QueuedTime Si la demande est actuellement mise en file d'attente, il retourne le moment où la demande a été dans la file d'attente.Une fois la demande quitte la file d'attente, il retourne le temps passé en file d'attente.
Propriété publique RecursiveSqlCalls Utilisé pour capturer les divers appels SQL Server.
Propriété protégée RequestRestrictions
Propriété publique RootContext Obtient le contexte racine associé à ce contexte de la requête.
Propriété publique ServiceHost Récupère ServiceHost que cette requête fait partie.
Propriété publique ServiceName Cette propriété représente le service Web ou l'application qui répondent à cette demande.Service de gestion peut éventuellement définir cette propriété.
Propriété publique SqlCalls Utilisé pour capturer les divers appels SQL Server.
Propriété publique StartTime C'est le point que la requête a été démarrée.
Propriété publique Status Lire et écrire l'état actuel de la demande en définissant une exception pour cette requête.
Propriété publique UniqueAgentIdentifier Retourne une chaîne d'identification de l'Agent d'option spécifiée par le client.La valeur est semblable à UniqueIdentifier et UserAgent et sera utilisée pour mettre en corrélation que des demandes provenant d'une application sur un ordinateur même si le redémarrage de processus mis en forme : X-VSS-agent : SomeUniqueAgentIdString
Propriété publique UniqueIdentifier Retourne l'identificateur facultatif command spécifié par le client.Cet identificateur est passé par le client dans un en-tête HTTP dans le mis en forme : X-TFS-instance : <Guid> [, <Command>]
Propriété publique UserAgent Cela donne la chaîne d'application fournie au serveur via l'en-tête de Http UserAgent.
Propriété publique UserContext Apprêtent l'utilisateur associé à cette requête Web.

Début

Méthodes

  Nom Description
Méthode publique BuildHyperlink(String)
Méthode publique BuildHyperlink(String, Guid)
Méthode publique Cancel Annule synchrone une demande. (Substitue RequestContextBase.Cancel(String).)
Méthode publique CreateComponent<TComponent>() Crée un composant qui peut être utilisé pour communiquer à la version actuelle de la base de données.
Méthode publique CreateComponent<TComponent>(String) Crée un composant qui peut être utilisé pour communiquer à la version actuelle de la base de données.
Méthode publique CreateImpersonationContext Personnifie l'identité cible sur l'hôte actuel de service.L'utilisateur authentifié sera le compte de service exécutant la méthode.
Méthode publique Dispose() (Hérité de RequestContextBase.)
Méthode protégée Dispose(Boolean) (Substitue RequestContextBase.Dispose(Boolean).)
Méthode publique Elevate() Retourne un SystemRequestContext. Si le contexte actuel est un contexte système, il se retourne.
Méthode publique Elevate(Boolean) Retourne un SystemRequestContext.Si le contexte actuel est un contexte système, il se retourne.Cet RequestContext est géré par le contexte propriétaire et ne doit pas être supprimé après l'appelant est terminée, il sera ajouté lorsque le contexte racine est supprimé.
Méthode publique EnterCancelableRegion Associe un objet annulable avec cette demande.
Méthode publique EnterMethod EnterMethod est appelé au début de l'exécution d'un WebMethod, d'HttpHandler ou de la tâche en arrière-plan.EnterMethod doit être appelé le thread qui exécute la demande.
Méthode publique Equals Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publique ExitCancelableRegion Supprime une association d'un objet annulable de cette demande.
Méthode protégée Finalize Veillez à libérer les verrous lorsque vous êtes finalisé même si vous n'avez pas été supprimé.Normalement elles est considéré comme une erreur générée lors ne disposant pas l'objet, mais les problèmes de synchronisation peuvent vous empêcher d'extraire jamais une référence à un contexte nouvellement créée.Ce finaliseur libère les ressources dans ce cas. (Substitue Object.Finalize().)
Méthode publique GetAuthenticatedIdentity L'identité authentifiée est l'identité de l'utilisateur/du service qui effectue la demande.Dans le cas de l'emprunt d'identité, cette identité est celle personnifiant l'UserContext.Lorsque l'emprunt d'identité n'est pas utilisé, cette identité est identique à celle de l'UserContext.La raison que c'est une fonction avec un paramètre de sortie au lieu d'une propriété est car elle ne doit pas être facilement confondue avec l'UserContext qui contient des appelants d'identité recherche une majorité du temps.
Méthode publique GetClient<T>() Obtenez une instance du client spécifié par le type T.
Méthode publique GetClient<T>(Uri, String, Guid, Boolean)
Méthode publique GetHashCode Générez code de hachage personnalisé pour cet objet selon les valeurs principales dans l'enregistrement. (Substitue Object.GetHashCode().)
Méthode publique GetReplicaAwareService<T> Obtenez une instance de la classe spécifiée par le type T, correspondant au réplica où ce contexte de la requête est mappé.Cet objet est l'instance associée à ce contexte de la requête.Si le service d'instance de fabrique de T n'existe pas, il est créé et initialisé avec l'instance de T pour chaque réplica disponible.Cette fonction est déterministe par utilisateur (tant que le nombre de réplica ne fait pas modifier).Les demandes du même utilisateur retournent la même instance de T.Notez ces objets peuvent être associés au ServiceHost et avoir une durée de vie que la requête elle-même.
Méthode publique GetService<T> Obtenez une instance de la classe spécifiée par le type T.Cet objet est l'instance associée à ce contexte de la requête.Si une instance n'est pas encore associée à ce contexte, il sera créé puis retourné à l'avenir.Ces objets peuvent être associés avec ServiceHost et avoir une durée de vie que la requête elle-même.
Méthode publique GetSessionValue l'GetSessionValue examine le contexte de la requête actuelle et retourne la valeur de la clé de session fournie.Les sessions peuvent être prises en charge par le type spécifique de contexte de la requête.Cela signifie que l'appelant doit travailler même lorsque des sessions ne sont pas prises en charge.Si le contexte de la requête prend en charge les sessions, il contiendra les valeurs entre les appels d'une session donnée.Une session est souvent une série de processus par un utilisateur unique où le serveur souhaite permettre au client de réutiliser une valeur pour la durée du processus.
Méthode publique GetSummary Résumé du contexte de la requête d'Team Foundation au format de chaîne.
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique InitializeRecursiveSqlCalls Utilisé pour capturer les divers appels SQL Server sur le contexte actuel et également à tous les contextes associés du système et d'utilisateur.
Méthode publique IsCanceled Détermine si la demande actuelle a été annulée.
Méthode publique IsTracing Renvoie True si le traçage est activé pour les arguments fournis.
Méthode publique LeaveMethod LeaveMethod est appelé lorsque la portée de la méthode est autorisée.Cela active le suivi de la portée de la méthode.
Méthode publique LogItem Enregistre une paire clé/valeur au conteneur d'éléments de contexte de la requête.
Méthode publique LogSqlCall Ajoutez un appel SQL Server aux journaux d'appels SQL Server.
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publique PartialResultsReady PartialResultsReady est appelé lorsque la commande exécute et la commande a déterminé qu'assez du résultat est prêt mais pas la totalité.Cela implique que l'appelant peut démarrer accéder aux données mais il existe plus de données pour la réponse qui est disponible.
Méthode publique SetMethodName Définit la méthode actuelle mais ne fait pas écrivent la méthode - c'est destiné à vous aider à diagnostiquer les commandes qui échouent avant qu'ils obtiennent à EnterMethod.Nous ne nous attendons pas à ce que les paramètres soient défini à ce stade.
Méthode publique SetSessionValue SetSessionValue est utilisé pour ajouter un nom à la session active de demandes.
Méthode publique ThrowIfCanceled Lève une exception si la demande actuelle a été annulée.
Méthode publique To Pour est utilisé pour récupérer un requestContext qui peut être utilisé pour exécuter dans un autre hôte de service.Le requestContext racine possède ce contexte ; Par conséquent, le requestContext ne doit pas être supprimé lorsque l'appelant a fini.Il sera supprimé lorsque le contexte propriétaire est supprimé.
Méthode publique ToString (Substitue Object.ToString().)
Méthode publique Trace(Int32, TraceLevel, String, String, String, array<Object[]) Trace sans balises définies par l'utilisateur spécifiques appliquées. (Substitue RequestContextBase.Trace(Int32, TraceLevel, String, String, String, array<Object[]).)
Méthode publique Trace(Int32, TraceLevel, String, String, array<String[], String, array<Object[])
Méthode publique TraceEnter Trace sur l'entrée d'une méthode.
Méthode publique TraceException(Int32, String, String, Exception) Tracer une exception.
Méthode publique TraceException(Int32, TraceLevel, String, String, Exception) Tracer une exception avec un niveau explicite.
Méthode publique TraceLeave Trace sur la sortie d'une méthode.
Méthode publique TraceSql
Méthode publique TryGetItem<T>

Début

Méthodes d'extension

  Nom Description
Méthode d'extension publique CreateComponent<TInterface, TComponent>() Surchargé. Crée un composant qui peut être utilisé pour communiquer à la version actuelle de la base de données.Construction via une interface afin qu'elle soit plus simplement false/stubbable à des faux. (Défini par RequestContextExtensions.)
Méthode d'extension publique CreateComponent<TInterface, TComponent>(String) Surchargé. Crée un composant qui peut être utilisé pour communiquer à la version actuelle de la base de données.Construction via une interface afin qu'elle soit plus simplement false/stubbable à des faux. (Défini par RequestContextExtensions.)
Méthode d'extension publique GetNameToDisplay (Défini par Extensions.)
Méthode d'extension publique IsFeatureEnabled Active TeamFoundationFeatureAvailabilityService pour déterminer si la fonction est activée.Le contexte de la requête est élevé pour ignorer les vérifications de sécurité qui est autorisé ici car la demande est initialisée côté serveur. (Défini par FeatureAvailabilityExtensionMethods.)
Méthode d'extension publique TraceBlock(Int32, Int32, String, String, String) Surchargé. Appelle la méthode de requestContext.TraceEnter et retourne une instance IDisposable pour l'appel de requestContext.TraceLeave.Cet appel de méthode doit être encapsulé avec une instruction using.La méthode d'IDisposable.Dispose n'est pas thread-safe.L'appelant doit effectuer la synchronisation s'il souhaite partager l'isntance IDisposable avec d'autres threads. (Défini par TeamFoundationTracingExtensionMethods.)
Méthode d'extension publique TraceBlock(Int32, Int32, Int32, String, String, String, Action) Surchargé. Encapsule une action avec des méthodes de TraceEnter et de TraceLeave.Lorsqu'il existe une exception il TraceException. (Défini par TeamFoundationTracingExtensionMethods.)

Début

Champs

  Nom Description
Champ protégé m_activityId

Début

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.TeamFoundation.Framework.Server, espace de noms