Metodo ITextTemplatingEngineHost.LoadIncludeText
Acquisisce il testo che corrisponde a una richiesta di includere un file modello di testo parziale.
Spazio dei nomi: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (in Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)
Sintassi
'Dichiarazione
Function LoadIncludeText ( _
requestFileName As String, _
<OutAttribute> ByRef content As String, _
<OutAttribute> ByRef location As String _
) As Boolean
bool LoadIncludeText(
string requestFileName,
out string content,
out string location
)
bool LoadIncludeText(
String^ requestFileName,
[OutAttribute] String^% content,
[OutAttribute] String^% location
)
abstract LoadIncludeText :
requestFileName:string *
content:string byref *
location:string byref -> bool
function LoadIncludeText(
requestFileName : String,
content : String,
location : String
) : boolean
Parametri
- requestFileName
Tipo: System.String
Il nome del file modello di testo parziale da acquistare.
- content
Tipo: System.String%
In String che contiene il testo acquisito o Empty se il file non è stato trovato.
- location
Tipo: System.String%
In String contenente la posizione del testo acquisito.Se l'host cerca il Registro di sistema il percorso dei file di inclusione o se l'host trova più percorsi per impostazione predefinita, l'host può restituire il percorso finale del file di inclusione in questo parametro.l'host può impostare location in Empty se il file non può essere trovato o se l'host non viene file system base.
Valore restituito
Tipo: System.Boolean
true per indicare che l'host è stato possibile acquisire il testo; in caso contrario, false.
Note
se l'utente ha specificato il facoltativo include la direttiva nel modello di testo, il motore chiama questo metodo.Questo metodo può essere chiamato 0, 1, o più volte per ogni trasformazione.Per ulteriori informazioni, vedere Direttive di modello di testo T4.
Questo metodo può essere chiamato da un processore di direttiva personalizzato.
Esempi
Nell'esempio di codice seguente viene illustrata un'implementazione anche un host personalizzato.Questo esempio di codice fa parte di un esempio più esaustivo.per l'esempio completo, vedere Procedura dettagliata: creazione di un host del modello di testo personalizzato.
public bool LoadIncludeText(string requestFileName, out string content, out string location)
{
content = System.String.Empty;
location = System.String.Empty;
//If the argument is the fully qualified path of an existing file,
//then we are done.
//----------------------------------------------------------------
if (File.Exists(requestFileName))
{
content = File.ReadAllText(requestFileName);
return true;
}
//This can be customized to search specific paths for the file.
//This can be customized to accept paths to search as command line
//arguments.
//----------------------------------------------------------------
else
{
return false;
}
}
Public Function LoadIncludeText(ByVal requestFileName As String, ByRef content As String, ByRef location As String) As Boolean Implements ITextTemplatingEngineHost.LoadIncludeText
content = System.String.Empty
location = System.String.Empty
'If the argument is the fully qualified path of an existing file,
'then we are done.
'----------------------------------------------------------------
If File.Exists(requestFileName) Then
content = File.ReadAllText(requestFileName)
Return True
'This can be customized to search specific paths for the file.
'This can be customized to accept paths to search as command line
'arguments.
'----------------------------------------------------------------
Else
Return False
End If
End Function
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.
Vedere anche
Riferimenti
ITextTemplatingEngineHost Interfaccia
Spazio dei nomi Microsoft.VisualStudio.TextTemplating
Altre risorse
Procedura dettagliata: creazione di un host del modello di testo personalizzato