SaveAsXml(Stream) メソッド

すべてのプロパティを含めて、レイアウトをストリームに保存します。

シンタックス

Visual Basic

'宣言
 
Public Overloads Sub SaveAsXml( _
   ByVal stream As Stream _
) 

C#

public void SaveAsXml( 
   Stream stream
)

パラメータ

stream

書き込み先のストリーム。

解説

このメソッドを呼び出すと、レイアウトがストリームに保存されます。ストリームを使用すれば、ディスク上のファイル、インターネット上の場所、メモリなどのさまざまな場所にレイアウト データを保存できます。

保存されたレイアウトを復元するには、LoadFromXml(Stream) メソッドを呼び出します。

Clone および CopyFrom メソッドを呼び出すと、レイアウトの複製を作成できます。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private XML_LAYOUT_FILE_PATH As String = "c:\\test.layout.xml"

  Private Sub Button92_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button92.Click

      ' Following code saves the ultraGrid1's layout to a file in xml format.
      Dim fs As System.IO.FileStream = Nothing

      Try
          ' Open a new file to save the layout to.
          fs = New System.IO.FileStream(XML_LAYOUT_FILE_PATH, System.IO.FileMode.Create, System.IO.FileAccess.Write, System.IO.FileShare.None)
      Catch exc As Exception
          MessageBox.Show(Me, XML_LAYOUT_FILE_PATH & " file not found. " & exc.Message, "Unable to open file", MessageBoxButtons.OK, MessageBoxIcon.Error)
          Return
      End Try

      ' Save the layout to the file in xml format.
      Me.UltraGrid1.DisplayLayout.SaveAsXml(fs, PropertyCategories.All)

      fs.Close()

  End Sub

  Private Sub Button93_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button93.Click

      ' Following code loads the saved layout from a file that was saved in xml format.

      Dim fs As System.IO.FileStream = Nothing

      Try
          ' Open the file where we saved the layout to in xml format.
          fs = New System.IO.FileStream(XML_LAYOUT_FILE_PATH, System.IO.FileMode.Open, System.IO.FileAccess.Read, System.IO.FileShare.Read)
      Catch exc As Exception

          MessageBox.Show(Me, XML_LAYOUT_FILE_PATH & " file not found. " & exc.Message, "Unable to open file", MessageBoxButtons.OK, MessageBoxIcon.Error)
          Return
      End Try

      ' Load the layout from the input stream by calling LoadFromXml method. It is very important 
      ' that you reset the Position of the file stream to where the layout data begins in case the 
      ' file stream has been read from previously.
      Me.UltraGrid1.DisplayLayout.LoadFromXml(fs, PropertyCategories.All)

      ' Close the file.
      fs.Close()

  End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private string XML_LAYOUT_FILE_PATH = "c:\\test.layout.xml";

private void button92_Click(object sender, System.EventArgs e)
{
	// Following code saves the ultraGrid1's layout to a file in xml format.
	System.IO.FileStream fs = null;
	
	try
	{
		// Open a new file to save the layout to.
		fs = new System.IO.FileStream( XML_LAYOUT_FILE_PATH, System.IO.FileMode.Create, System.IO.FileAccess.Write, System.IO.FileShare.None );
	}
	catch ( Exception exc )
	{
		MessageBox.Show( this, XML_LAYOUT_FILE_PATH + " file not found. " + exc.Message, "Unable to open file", MessageBoxButtons.OK, MessageBoxIcon.Error );
		return;
	}

	// Save the layout to the file in xml format.
	this.ultraGrid1.DisplayLayout.SaveAsXml( fs, PropertyCategories.All );

	fs.Close( );
}

private void button93_Click(object sender, System.EventArgs e)
{
	// Following code loads the saved layout from a file that was saved in xml format.

	System.IO.FileStream fs = null;
	
	try
	{
		// Open the file where we saved the layout to in xml format.
		fs = new System.IO.FileStream( XML_LAYOUT_FILE_PATH, System.IO.FileMode.Open, System.IO.FileAccess.Read, System.IO.FileShare.Read );
	}
	catch ( Exception exc )
	{

		MessageBox.Show( this, XML_LAYOUT_FILE_PATH + " file not found. " + exc.Message, "Unable to open file", MessageBoxButtons.OK, MessageBoxIcon.Error );
		return;
	}

	// Load the layout from the input stream by calling LoadFromXml method. It is very important 
	// that you reset the Position of the file stream to where the layout data begins in case the 
	// file stream has been read from previously.
	this.ultraGrid1.DisplayLayout.LoadFromXml( fs, PropertyCategories.All );

	// Close the file.
	fs.Close( );
}