Load(Stream) メソッド

すべてのプロパティを含めて、レイアウトをストリームから読み込みします。

シンタックス

Visual Basic

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

C#

public void Load( 
   Stream stream
)

パラメータ

stream

読み込むストリーム。

解説

このメソッドを呼び出すと、Save(Stream) メソッドによって作成されたレイアウトがストリームからロードされます。ストリームを使用すれば、ディスク上のファイル、インターネット上の場所、メモリなどのさまざまなソースからレイアウト データを取得できます。

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

使用例

Visual Basic

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

  Private LAYOUT_FILE_PATH As String = "c:\\test.layout"

  Private Sub Button90_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button90.Click

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

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

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

      ' Close the file.
      fs.Close()

  End Sub

  Private Sub Button91_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button91.Click

      ' Following code loads the saved layout from a file.
      Dim fs As System.IO.FileStream = Nothing

      Try
          ' Open the file where the layout has been saved before.
          fs = New System.IO.FileStream(LAYOUT_FILE_PATH, System.IO.FileMode.Open, System.IO.FileAccess.Read, System.IO.FileShare.Read)
      Catch exc As Exception
          MessageBox.Show(Me, 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 Load 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.
      fs.Position = 0
      Me.UltraGrid1.DisplayLayout.Load(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 LAYOUT_FILE_PATH = "c:\\test.layout";

private void button90_Click(object sender, System.EventArgs e)
{
	// Following code saves the ultraGrid1's layout to a file.

	System.IO.FileStream fs = null;
	
	try
	{
		// Open a new file to save the layout to.
		fs = new System.IO.FileStream( LAYOUT_FILE_PATH, System.IO.FileMode.Create, System.IO.FileAccess.Write, System.IO.FileShare.None );
	}
	catch ( Exception exc )
	{
		MessageBox.Show( this, "Unable to create a new file " + LAYOUT_FILE_PATH + " for saving the layout. " + exc.Message, "Unable to create file", MessageBoxButtons.OK, MessageBoxIcon.Error );
		return;
	}

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

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

}

private void button91_Click(object sender, System.EventArgs e)
{
	// Following code loads the saved layout from a file.

	System.IO.FileStream fs = null;
	
	try
	{
		// Open the file where the layout has been saved before.
		fs = new System.IO.FileStream( LAYOUT_FILE_PATH, System.IO.FileMode.Open, System.IO.FileAccess.Read, System.IO.FileShare.Read );
	}
	catch ( Exception exc )
	{
		MessageBox.Show( this, 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 Load 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.
	fs.Position = 0;
	this.ultraGrid1.DisplayLayout.Load( fs, PropertyCategories.All );

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