ヘッダーをスキップ

Oracle® Data Provider for .NET開発者ガイド
リリース9.2.0.4

部品番号 B13807-01
Go To Table Of Contents
目次
Go To Index
索引

Go to previous page Go to beginning of chapter Go to next page

Oracle.DataAccess.Typesネームスペース(ODP.NET型)、18/19


OracleXmlStreamクラス

OracleXmlStreamオブジェクトは、OracleXmlTypeオブジェクトに格納された読取り専用ストリームのXMLデータを表します。

クラスの継承

Object

  MarshalByRefObject

    Stream

      OracleXmlStream

宣言
// C#
public sealed class OracleXmlStream : IDisposable, ICloneable
スレッド・セーフティ

インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。

// C#

要件

ネームスペース: Oracle.DataAccess.Types

アセンブリ: Oracle.DataAccess.dll

このクラスは、Oracle9i リリース2(9.2)以上でのみ使用できます。

関連項目:

OracleXmlStreamのメンバー

OracleXmlStreamのメンバーを次の表に示します。

OracleXmlStreamのコンストラクタ

OracleXmlStreamのコンストラクタを表5-180に示します。

表5-180 OracleXmlStreamのコンストラクタ
コンストラクタ 説明

OracleXmlStreamのコンストラクタ

OracleXmlTypeに格納されたStream表現のXMLデータを提供するOracleXmlStreamオブジェクトのインスタンスを作成します。

OracleXmlStreamのstaticメソッド

OracleXmlStreamのstaticメソッドを表5-181に示します。

表5-181 OracleXmlStreamのstaticメソッド
メソッド 説明

Equals

Objectから継承されます(オーバーロード)。

OracleXmlStreamのインスタンス・プロパティ

OracleXmlStreamのインスタンス・プロパティを表5-182に示します。

表5-182 OracleXmlStreamのインスタンス・プロパティ
プロパティ 説明

CanRead

XMLストリームを読み込むことができるかどうかを示します。

CanSeek

順方向および逆方向のシーク操作を実行できるかどうかを示します。

CanWrite

サポートされていません。

Connection

XMLデータの取得に使用されるOracleConnectionを示します。

Length

XMLストリームのバイト数を示します。

Position

ストリーム内のバイト位置を取得または設定します。

Value

ストリームの最初の文字から始まるXMLデータを文字列として返します。

OracleXmlStreamのインスタンス・メソッド

OracleXmlStreamのインスタンス・メソッドを表5-183に示します。

表5-183 OracleXmlStreamのインスタンス・メソッド
メソッド 説明

BeginRead

Streamから継承されます。

BeginWrite

Streamから継承されます。

Clone

OracleXmlStreamオブジェクトのコピーを作成します。

Close

現在のストリームをクローズし、それに関連付けられたリソースを解放します。

Dispose

このオブジェクトによって割り当てられたリソースを解放します。

EndRead

Streamから継承されます。

EndWrite

Streamから継承されます。

Equals

Objectから継承されます。

Flush

サポートされていません。

GetHashCode

Objectから継承されます。

GetLifetimeService

MarshalByRefObjectから継承されます。

GetType

Objectから継承されます。

InitializeLifetimeService

MarshalByRefObjectから継承されます。

Read

指定されたデータ量を現在のストリームのインスタンスから読み込み、配列バッファに移入します(オーバーロード)。

ReadByte

Streamから継承されます。

Seek

現在のストリームに位置を設定し、現在のストリームの新しい位置を返します。

SetLength

サポートされていません。

ToString

Objectから継承されます。

Write

サポートされていません。

WriteByte

サポートされていません。

関連項目:

OracleXmlStreamのコンストラクタ

このコンストラクタは、OracleXmlTypeに格納されたStream表現のXMLデータを提供するOracleXmlStreamオブジェクトのインスタンスを作成します。

宣言
// C#
public OracleXmlStream(OracleXmlType xmlType);
パラメータ
備考

OracleXmlStreamは、構成元となったOracleXmlTypeオブジェクトのOracleConnectionオブジェクトを暗黙的に使用します。

関連項目:

OracleXmlStreamのstaticメソッド

OracleXmlStreamのstaticメソッドを表5-184に示します。

表5-184 OracleXmlStreamのstaticメソッド
メソッド 説明

Equals

Objectから継承されます(オーバーロード)。

関連項目:

OracleXmlStreamのインスタンス・プロパティ

OracleXmlStreamのインスタンス・プロパティを表5-185に示します。

表5-185 OracleXmlStreamのインスタンス・プロパティ
プロパティ 説明

CanRead

XMLストリームを読み込むことができるかどうかを示します。

CanSeek

順方向および逆方向のシーク操作を実行できるかどうかを示します。

CanWrite

サポートされていません。

Connection

XMLデータの取得に使用されるOracleConnectionを示します。

Length

XMLストリームのバイト数を示します。

Position

ストリーム内のバイト位置を取得または設定します。

Value

ストリームの最初の文字から始まるXMLデータを文字列として返します。

関連項目:

CanRead

Streamをオーバーライドします。

このプロパティは、XMLストリームを読み込むことができるかどうかを示します。

宣言
// C#
public override bool CanRead{get;}
プロパティ値

XMLストリームを読み込むことができる場合、trueを返します。それ以外の場合、falseを返します。

関連項目:

CanSeek

Streamをオーバーライドします。

このプロパティは、順方向および逆方向のシーク操作を実行できるかどうかを示します。

宣言
// C#
public override bool CanSeek{get;}
プロパティ値

順方向および逆方向のシーク操作を実行できる場合、trueを返します。それ以外の場合、falseを返します。

関連項目:

Connection

このインスタンス・プロパティは、XMLデータの取得に使用されるOracleConnectionを示します。

宣言
// C#
public OracleConnection Connection {get;}

プロパティ値

OracleConnection

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

関連項目:

Length

Streamをオーバーライドします。

このプロパティは、XMLストリームのバイト数を示します。

宣言
// C#
public override Int64 Length{get;}
プロパティ値

XMLストリームのバイト数を表すInt64値。空のストリームの長さは0バイトです。

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。

関連項目:

Position

Streamをオーバーライドします。

このプロパティは、ストリーム内のバイト位置を取得または設定します。

宣言
// C#
public override Int64 Position{get; set;}
プロパティ値

ストリームの現在の位置を示すInt64

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。

ArgumentOutOfRangeException: Positionが0より小さいです。

備考

ストリームの開始位置は0で表されます。ストリームの長さを超える位置のシークはサポートされます。

関連項目:

Value

このプロパティは、ストリームの最初の文字から始まるXMLデータを文字列として返します。

宣言
// C#
public string Value{get; set;}
プロパティ値

string

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。

備考

Positionの値は、このプロパティを使用しても使用または変更されません。

このプロパティによって返される文字列の最大長は2GBです。

関連項目:

OracleXmlStreamのインスタンス・メソッド

OracleXmlStreamのインスタンス・メソッドを表5-186に示します。

表5-186 OracleXmlStreamのインスタンス・メソッド
メソッド 説明

BeginRead

Streamから継承されます。

BeginWrite

Streamから継承されます。

Clone

OracleXmlStreamオブジェクトのコピーを作成します。

Close

現在のストリームをクローズし、それに関連付けられたリソースを解放します。

Dispose

このオブジェクトによって割り当てられたリソースを解放します。

EndRead

Streamから継承されます。

EndWrite

Streamから継承されます。

Equals

Objectから継承されます。

Flush

サポートされていません。

GetHashCode

Objectから継承されます。

GetLifetimeService

MarshalByRefObjectから継承されます。

GetType

Objectから継承されます。

InitializeLifetimeService

MarshalByRefObjectから継承されます。

Read

指定されたデータ量を現在のXMLストリームのインスタンスから読み込み、配列バッファに移入します(オーバーロード)。

ReadByte

Streamから継承されます。

Seek

現在のストリームに位置を設定し、現在のストリームの新しい位置を返します。

SetLength

サポートされていません。

ToString

Objectから継承されます。

Write

サポートされていません。

WriteByte

サポートされていません。

関連項目:

Clone

このメソッドは、OracleXmlStreamオブジェクトのコピーを作成します。

宣言
// C#
public object Clone();
戻り値

OracleXmlStreamオブジェクト

実装

ICloneable

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。

備考

クローニングされたオブジェクトは、クローニング元のオブジェクトと同じプロパティ値を持ちます。

// C#
...
//Need a proper casting for the return value when cloned
OracleXmlStream oraXmlStream_cloned = (OracleXmlStream) oraXmlStream.Clone();
...

関連項目:

Close

Streamをオーバーライドします。

このメソッドは、現在のストリームをクローズし、それに関連付けられたリソースを解放します。

宣言
// C#
public override void Close();

関連項目:

Dispose

このpublicメソッドは、このオブジェクトによって割り当てられたリソースを解放します。

宣言
// C#
public void Dispose();
実装

IDisposable

備考

オブジェクトは、破棄後に再利用することはできません。引き続きアクセスできるプロパティもありますが、その値は保証されない場合があります。リソースは解放されているため、メソッドのコールにより例外が発生することがあります。

関連項目:

Read

このメソッドは、指定されたデータ量を現在のXMLストリームのインスタンスから読み込み、配列バッファに移入します。

オーバーロード一覧:

Read(byte [ ], int, int)

Streamをオーバーライドします。

このメソッドは、指定されたUnicodeバイト数を現在のインスタンスから読み込み、ストリーム内の位置を進め、バイト配列バッファに移入します。

宣言
// C#
public override int Read(byte[ ] buffer, int offset, int count);
パラメータ
戻り値

指定されたbyte[]バッファに読み込まれたUnicodeバイト数、またはストリームの終わりに達した場合は0

備考

このメソッドは、最大バイト数countを現在のストリームから読み込み、offsetから始まるバッファに格納します。ストリーム内の現在の位置は、読み込まれたバイト数の分だけ進みます。ただし、例外が発生した場合、ストリーム内の現在の位置は変らないままです。

XMLデータは、Positionプロパティによって指定された位置から読み込まれます。

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。

関連項目:

Read(char [ ], int, int)

Streamをオーバーライドします。

このメソッドは、指定された文字数を現在のインスタンスから読み込み、ストリーム内の位置を進め、文字配列バッファに移入します。

宣言
// C#
public override int Read(char[ ] buffer, int offset, int count);
パラメータ
戻り値

戻り値は、ストリームから読み込まれた文字数、またはストリームの終わりに達した場合は0を示します。

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。

備考

このメソッドでは、ストリームのインスタンスのPositionが0または偶数である必要があります。

XMLデータは、Positionプロパティによって指定された位置から読み込まれます。

関連項目:

Seek

Streamをオーバーライドします。

このメソッドは、現在のストリームに位置を設定し、現在のストリームの新しい位置を返します。

宣言
// C#
public long Seek(long offset, SeekOrigin origin);
パラメータ
戻り値

現在のストリーム内の新しい位置

例外

ObjectDisposedException: オブジェクトがすでに破棄されています。

InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。

備考

CanSeekプロパティを使用して、現在のインスタンスでシークがサポートされるかどうかを判断します。ストリームの長さを超える位置のシークはサポートされます。

関連項目:


Go to previous page Go to beginning of chapter Go to next page
Oracle
Copyright © 2002, 2003 Oracle Corporation.

All Rights Reserved.
Go To Table Of Contents
目次
Go To Index
索引