Condividi tramite


Metodo ITextDocumentFactoryService.CreateAndLoadTextDocument (String, IContentType, Boolean, Boolean%)

crea ITextDocument che apre e carica il contenuto del file in un nuovo ITextBuffer.

Spazio dei nomi:  Microsoft.VisualStudio.Text
Assembly:  Microsoft.VisualStudio.Text.Data (in Microsoft.VisualStudio.Text.Data.dll)

Sintassi

'Dichiarazione
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

Parametri

  • filePath
    Tipo: String

    Il percorso completo del file da caricare.

  • attemptUtf8Detection
    Tipo: Boolean

    se tentare di caricare il documento come file UTF-8.

  • characterSubstitutionsOccurred
    Tipo: Boolean%

    [out] Impostare su true se alcuni byte del file non è stato possibile convertire direttamente utilizzando la codifica specificata.

Valore restituito

Tipo: Microsoft.VisualStudio.Text.ITextDocument
ITextDocument .

Eccezioni

Eccezione Condizione
ArgumentNullException

filePath o contentType viene nullriferimento null (Nothing in Visual Basic).

Note

L'implementazione di Visual Studio di questo metodo rileva il file di codice come segue:

  1. Se c " è un indicatore dell'ordine dei byte, quindi utilizzare la codifica corrispondente.

  2. In caso contrario, scorrere IEncodingDetector oggetti corrispondenti contentType il parametro finché uno restituisce un valore diverso da Null Encoding valore e utilizzano la codifica.

  3. Se nessuna codifica è stata rilevata e attemptUtf8Detection il flag è impostato e il flusso può essere codificato come UTF8 ma NON ASCII, utilizzare UTF8.

  4. In alternativa, utilizzare la codifica predefinita di sistema.

Sicurezza di .NET Framework

Vedere anche

Riferimenti

ITextDocumentFactoryService Interfaccia

Overload CreateAndLoadTextDocument

Spazio dei nomi Microsoft.VisualStudio.Text