TextRange.Save 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 선택 영역을 지정된 스트림에 지정된 데이터 형식으로 저장합니다.
오버로드
Save(Stream, String) |
현재 선택 영역을 지정된 스트림에 지정된 데이터 형식으로 저장합니다. |
Save(Stream, String, Boolean) |
현재 선택 영역을 지정된 데이터 형식으로 지정된 스트림에 저장하며, 사용자 지정 TextElement 개체를 보존할 수 있습니다. |
Save(Stream, String)
현재 선택 영역을 지정된 스트림에 지정된 데이터 형식으로 저장합니다.
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)
매개 변수
- stream
- Stream
현재 선택 영역을 저장할 쓸 수 있는 빈 스트림입니다.
- dataFormat
- String
현재 선택 영역을 저장할 데이터 형식입니다. 현재 지원되는 데이터 형식에는 Rtf, Text, Xaml 및 XamlPackage가 있습니다.
예외
stream
또는 dataFormat
가 null
인 경우
예제
다음 예제에서는 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
설명
이 메서드는 반환 될 때 stream
열고 내의 현재 위치에 그대로 stream
정의 되지 않습니다.
저장의 일부로 작업을 현재 선택 영역의 콘텐츠 변환 될 수 있습니다 하 여 지정 된 데이터 형식 dataFormat
합니다.
추가 정보
적용 대상
Save(Stream, String, Boolean)
현재 선택 영역을 지정된 데이터 형식으로 지정된 스트림에 저장하며, 사용자 지정 TextElement 개체를 보존할 수 있습니다.
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)
매개 변수
- stream
- Stream
현재 선택 영역을 저장할 쓸 수 있는 빈 스트림입니다.
- dataFormat
- String
현재 선택 영역을 저장할 데이터 형식입니다. 현재 지원되는 데이터 형식에는 Rtf, Text, Xaml 및 XamlPackage가 있습니다.
- preserveTextElements
- Boolean
사용자 지정 TextElement 개체를 보존하려면 true
이고, 그렇지 않으면 false
입니다.
예외
stream
또는 dataFormat
가 null
인 경우 발생합니다.
지정된 데이터 형식이 지원되지 않는 경우.
stream
에서 로드한 콘텐츠가 지정된 데이터 형식과 일치하지 않을 경우에도 발생할 수 있습니다.
설명
때 preserveTextElements
됩니다 false
사용자 지정 TextElement 알려진 개체는 저장 TextElement 형식입니다. 예를 들어, 사용자 지정을 만들어 TextElement 호출 Heading1
에서 상속 하는 Paragraph합니다. 이 메서드를 호출 하면 preserveTextElements
로 설정 false
, Heading1
로 변환 됩니다를 Paragraph 경우는 TextRange 저장 됩니다. 이 메서드를 호출 하면 preserveTextElements
로 설정 true
, Heading1
변환 되지 않고 저장 됩니다. 사용자 지정 텍스트 요소를 보존할지 dataFormat
으로 설정 되어 있어야 DataFormats.Xaml합니다.
Save(Stream, String, Boolean) .NET Framework 버전 3.5에서에서 도입 되었습니다. 자세한 내용은 버전 및 종속성을 참조하세요.
적용 대상
.NET