TextRange.Save Metode

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationFramework.dll

Menyimpan pilihan saat ini ke aliran tertentu dalam format data tertentu.

Overload

Save(Stream, String)	Menyimpan pilihan saat ini ke aliran tertentu dalam format data tertentu.
Save(Stream, String, Boolean)	Menyimpan pilihan saat ini ke aliran tertentu dalam format data tertentu, dengan opsi mempertahankan objek TextElement kustom.

Save(Stream, String)

Menyimpan pilihan saat ini ke aliran tertentu dalam format data tertentu.

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)

Parameter

stream

Stream

Aliran kosong yang dapat ditulis untuk menyimpan pilihan saat ini.

dataFormat

String

Format data untuk menyimpan pilihan saat ini sebagai. Format data yang saat ini didukung Rtf, Text, Xaml, dan XamlPackage.

Pengecualian

ArgumentNullException

stream atau dataFormatnull.

ArgumentException

Format data yang ditentukan tidak didukung.

-atau

Konten yang dimuat dari stream tidak cocok dengan format data yang ditentukan.

Contoh

Contoh berikut menunjukkan penggunaan metode 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

Keterangan

Ketika metode ini kembali, stream dibiarkan terbuka, dan posisi saat ini dalam stream tidak terdefinisi.

Sebagai bagian dari operasi penyimpanan, konten dalam pilihan saat ini dapat dikonversi ke format data yang ditentukan oleh dataFormat.

Lihat juga

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

Save(Stream, String, Boolean)

Menyimpan pilihan saat ini ke aliran tertentu dalam format data tertentu, dengan opsi mempertahankan objek TextElement kustom.

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)

Parameter

stream

Stream

Aliran kosong yang dapat ditulis untuk menyimpan pilihan saat ini.

dataFormat

String

Format data untuk menyimpan pilihan saat ini sebagai. Format data yang saat ini didukung Rtf, Text, Xaml, dan XamlPackage.

preserveTextElements

Boolean

true untuk mempertahankan objek TextElement kustom; jika tidak, false.

Pengecualian

ArgumentNullException

Terjadi ketika stream atau dataFormatnull.

ArgumentException

Terjadi ketika format data yang ditentukan tidak didukung. Dapat juga dinaikkan jika konten yang dimuat dari stream tidak cocok dengan format data yang ditentukan.

Keterangan

Saat preserveTextElementsfalse, objek TextElement kustom disimpan sebagai jenis TextElement yang diketahui. Misalnya, Anda membuat TextElement kustom yang disebut Heading1, yang mewarisi dari Paragraph. Ketika Anda memanggil metode ini dengan preserveTextElements diatur ke false, Heading1 dikonversi ke Paragraph saat TextRange disimpan. Ketika Anda memanggil metode ini dengan preserveTextElements diatur ke true, Heading1 disimpan tanpa dikonversi. Untuk mempertahankan elemen teks kustom, dataFormat harus diatur ke DataFormats.Xaml.

Save(Stream, String, Boolean) diperkenalkan dalam .NET Framework versi 3.5. Untuk informasi selengkapnya, lihat Versi dan Dependensi .