ITextDocumentFactoryService.CreateAndLoadTextDocument, méthode (String, IContentType, Boolean, Boolean%)

Article
05/16/2015

Crée ITextDocument qui ouvre et charge le contenu du fichier dans nouvel ITextBuffer.

Espace de noms : Microsoft.VisualStudio.Text
Assembly : Microsoft.VisualStudio.Text.Data (dans Microsoft.VisualStudio.Text.Data.dll)

Syntaxe

'Déclaration
Function CreateAndLoadTextDocument ( _
    filePath As String, _
    contentType As IContentType, _
    attemptUtf8Detection As Boolean, _
    <OutAttribute> ByRef characterSubstitutionsOccurred As Boolean _
) As ITextDocument

ITextDocument CreateAndLoadTextDocument(
    string filePath,
    IContentType contentType,
    bool attemptUtf8Detection,
    out bool characterSubstitutionsOccurred
)

ITextDocument^ CreateAndLoadTextDocument(
    String^ filePath, 
    IContentType^ contentType, 
    bool attemptUtf8Detection, 
    [OutAttribute] bool% characterSubstitutionsOccurred
)

abstract CreateAndLoadTextDocument : 
        filePath:string * 
        contentType:IContentType * 
        attemptUtf8Detection:bool * 
        characterSubstitutionsOccurred:bool byref -> ITextDocument

function CreateAndLoadTextDocument(
    filePath : String, 
    contentType : IContentType, 
    attemptUtf8Detection : boolean, 
    characterSubstitutionsOccurred : boolean
) : ITextDocument

Paramètres

filePath
Type : String

Chemin d'accès complet au fichier à charger.

contentType
Type : Microsoft.VisualStudio.Utilities.IContentType

IContentType de la ITextBuffer.

attemptUtf8Detection
Type : Boolean

Indique s'il faut essayer de charger le document en tant que fichier UTF-8.

characterSubstitutionsOccurred
Type : Boolean%

[out] Défini sur true si certains des octets de fichier n'ont pas pu être traduits directement à l'aide de l'encodage donné.

Valeur de retour

Type : Microsoft.VisualStudio.Text.ITextDocument
ITextDocument .

Exceptions

Exception	Condition
ArgumentNullException	filePath ou contentType est nullune référence null (Nothing en Visual Basic).

Notes

L'implémentation de Visual Studio de cette méthode détecte le fichier encodant comme suit :

S'il existe une marque d'ordre d'octets ensuite, utilisez l'encodage correspondant.
Sinon, itérez via les objets d'IEncodingDetector qui correspondent à le paramètre d'contentType jusqu'à ce qu'il retourne une valeur non null d'Encoding, et l'utilisation qui encodage.
Si aucun encodage n'était détecté, et la balise d'attemptUtf8Detection est définie, et le flux de données peut être décodé comme UTF8 mais non ASCII, alors l'utilisation UTF8.
Sinon, utilisez l'encodage de valeur par défaut de système.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ITextDocumentFactoryService Interface

CreateAndLoadTextDocument, surcharge

Microsoft.VisualStudio.Text, espace de noms

Partager via