Partager via


Parse

Dernière modification : mercredi 1 décembre 2010

S’applique à : SharePoint Foundation 2010

Analyse le document spécifié et écrit les propriétés de document qu'il extrait vers le conteneur de propriétés spécifié.

HRESULT Parse(
   ILockBytes *pilb,
   IParserPropertyBag *pibag,
   VARIANT_BOOL *pfChanged
);

Paramètres

pilb

[in] Le document à analyser.

pilbag

[in] L'objet conteneur de propriétés dans lequel l'analyseur écrit les propriétés de document.

pfChanged

[out] Indique si l’analyseur a modifié le document. Cet argument prend la valeur True si l’analyseur a modifié le document et la valeur False dans le cas contraire.

Valeur renvoyée

Les méthodes d'analyse renvoient des valeurs HRESULT par défaut. En règle générale, les valeurs renvoyées sont positives OK lorsque l'analyse est réussie ou négatives FAIL lorsqu'elle échoue.

Remarques

Microsoft SharePoint Foundation préremplit l’objet conteneur des propriétés qu’il passe dans l’argument pilb avec n’importe quelle propriété de document déjà spécifiée pour le document.

Une fois que l’analyseur a exécuté cette méthode, SharePoint Foundation accède au conteneur des propriétés et détermine quelles sont les propriétés qui correspondent aux colonnes pour le document. Il promeut ensuite ces propriétés ou écrit la valeur de la propriété de document dans la colonne correspondante de la bibliothèque de documents. SharePoint Foundation promeut uniquement les propriétés qui correspondent aux colonnes applicables au document.

SharePoint Foundation stocke également la collection de propriétés de document en totalité dans une table de hachage ; cette table de hachage est accessible par programme à l'aide des propriétés SPFile.Properties.

Si l’analyseur modifie le document, comme spécifié par l’argument pfChanged, SharePoint Foundation télécharge le document mis à jour dans la bibliothèque de documents.

Pour plus d'informations, voir Promotion et rétrogradation de propriétés de document.

Voir aussi

Concepts

Analyseurs de documents personnalisés

Promotion et rétrogradation de propriétés de document

Vue d'ensemble de l'interface de l'analyseur de documents