TextRange.Save Metodo

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Salva la selezione corrente in un flusso specificato in un formato di dati specificato.

Overload

Save(Stream, String)	Salva la selezione corrente in un flusso specificato in un formato di dati specificato.
Save(Stream, String, Boolean)	Salva la selezione corrente in un flusso specificato in un formato di dati specificato, con l'opzione di mantenimento di oggetti TextElement personalizzati.

Save(Stream, String)

Salva la selezione corrente in un flusso specificato in un formato di dati specificato.

public:
 void Save(System::IO::Stream ^ stream, System::String ^ dataFormat);

public void Save (System.IO.Stream stream, string dataFormat);

member this.Save : System.IO.Stream * string -> unit

Public Sub Save (stream As Stream, dataFormat As String)

Parametri

stream

Stream

Flusso scrivibile vuoto in cui salvare la selezione corrente.

dataFormat

String

Formato dati per salvare la selezione corrente come. I formati di dati attualmente supportati sono Rtf, Text, Xamle XamlPackage.

Eccezioni

ArgumentNullException

stream o dataFormat è null.

ArgumentException

Il formato di dati specificato non è supportato.

-o

Il contenuto caricato da stream non corrisponde al formato di dati specificato.

Esempio

Nell'esempio seguente viene illustrato l'uso del metodo Save.

// This method accepts an input stream and a corresponding data format.  The method
// will attempt to load the input stream into a TextRange selection, apply Bold formatting
// to the selection, save the reformatted selection to an alternat stream, and return 
// the reformatted stream.  
Stream BoldFormatStream(Stream inputStream, string dataFormat)
{
    // A text container to read the stream into.
    FlowDocument workDoc = new FlowDocument();
    TextRange selection = new TextRange(workDoc.ContentStart, workDoc.ContentEnd);
    Stream outputStream = new MemoryStream();

    try
    {
        // Check for a valid data format, and then attempt to load the input stream
        // into the current selection.  Note that CanLoad ONLY checks whether dataFormat
        // is a currently supported data format for loading a TextRange.  It does not 
        // verify that the stream actually contains the specified format.  An exception 
        // may be raised when there is a mismatch between the specified data format and 
        // the data in the stream. 
        if (selection.CanLoad(dataFormat))
            selection.Load(inputStream, dataFormat);
    }
    catch (Exception e) { return outputStream; /* Load failure; return a null stream. */ }

    // Apply Bold formatting to the selection, if it is not empty.
    if (!selection.IsEmpty)
        selection.ApplyPropertyValue(TextElement.FontWeightProperty, FontWeights.Bold);

    // Save the formatted selection to a stream, and return the stream.
    if (selection.CanSave(dataFormat))
        selection.Save(outputStream, dataFormat);

    return outputStream;
}

' This method accepts an input stream and a corresponding data format.  The method
' will attempt to load the input stream into a TextRange selection, apply Bold formatting
' to the selection, save the reformatted selection to an alternat stream, and return 
' the reformatted stream.  
Private Function BoldFormatStream(ByVal inputStream As Stream, ByVal dataFormat As String) As Stream
    ' A text container to read the stream into.
    Dim workDoc As New FlowDocument()
    Dim selection As New TextRange(workDoc.ContentStart, workDoc.ContentEnd)
    Dim outputStream As Stream = New MemoryStream()

    Try
        ' Check for a valid data format, and then attempt to load the input stream
        ' into the current selection.  Note that CanLoad ONLY checks whether dataFormat
        ' is a currently supported data format for loading a TextRange.  It does not 
        ' verify that the stream actually contains the specified format.  An exception 
        ' may be raised when there is a mismatch between the specified data format and 
        ' the data in the stream. 
        If selection.CanLoad(dataFormat) Then
            selection.Load(inputStream, dataFormat)
        End If
    Catch e As Exception ' Load failure return a null stream. 
        Return outputStream
    End Try

    ' Apply Bold formatting to the selection, if it is not empty.
    If Not selection.IsEmpty Then
        selection.ApplyPropertyValue(TextElement.FontWeightProperty, FontWeights.Bold)
    End If

    ' Save the formatted selection to a stream, and return the stream.
    If selection.CanSave(dataFormat) Then
        selection.Save(outputStream, dataFormat)
    End If

    Return outputStream
End Function

Commenti

Quando termina, questo metodo stream viene lasciato aperto e la posizione corrente all'interno di stream non è definita.

Nell'ambito dell'operazione di salvataggio, il contenuto nella selezione corrente può essere convertito nel formato dati specificato da dataFormat.

Vedi anche

• CanSave(String)
• Load(Stream, String)
• CanLoad(String)

Save(Stream, String, Boolean)

Salva la selezione corrente in un flusso specificato in un formato di dati specificato, con l'opzione di mantenimento di oggetti TextElement personalizzati.

public:
 void Save(System::IO::Stream ^ stream, System::String ^ dataFormat, bool preserveTextElements);

public void Save (System.IO.Stream stream, string dataFormat, bool preserveTextElements);

member this.Save : System.IO.Stream * string * bool -> unit

Public Sub Save (stream As Stream, dataFormat As String, preserveTextElements As Boolean)

Parametri

stream

Stream

Flusso scrivibile vuoto in cui salvare la selezione corrente.

dataFormat

String

Formato dati per salvare la selezione corrente come. I formati di dati attualmente supportati sono Rtf, Text, Xamle XamlPackage.

preserveTextElements

Boolean

true per conservare oggetti TextElement personalizzati; in caso contrario, false.

Eccezioni

ArgumentNullException

Si verifica quando stream o dataFormat è null.

ArgumentException

Si verifica quando il formato dati specificato non è supportato. Può anche essere generato se il contenuto caricato da stream non corrisponde al formato di dati specificato.

Commenti

Quando preserveTextElements è false, gli oggetti TextElement personalizzati vengono salvati come tipi di TextElement noti. Si supponga, ad esempio, di creare un TextElement personalizzato denominato Heading1, che eredita da Paragraph. Quando si chiama questo metodo con preserveTextElements impostato su false, Heading1 viene convertito in un Paragraph quando viene salvato il TextRange. Quando si chiama questo metodo con preserveTextElements impostato su true, Heading1 viene salvato senza essere convertito. Per mantenere gli elementi di testo personalizzati, dataFormat deve essere impostato su DataFormats.Xaml.

Save(Stream, String, Boolean) è stato introdotto in .NET Framework versione 3.5. Per altre informazioni, vedere Versioni e dipendenze .