ヘッダーをスキップ

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型)、19/19


OracleXmlTypeクラス

OracleXmlTypeオブジェクトは、OracleのXMLTypeインスタンスを表します。

クラスの継承

Object

  OracleXmlType

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

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

備考

OracleXmlTypeオブジェクトは、XMLスキーマまたはXMLフラグメントの有無に関係なく整形式XML文書に使用できます。このリリースでは、非スキーマ・ベースのXMLのみサポートされます。

// C#
要件

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

アセンブリ: Oracle.DataAccess.dll

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

関連項目:

OracleXmlTypeのメンバー

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

OracleXmlTypeのコンストラクタ

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

表5-187 OracleXmlTypeのコンストラクタ
コンストラクタ 説明

OracleXmlTypeのコンストラクタ

OracleXmlTypeクラスのインスタンスを作成します(オーバーロード)。

OracleXmlTypeのstaticメソッド

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

表5-188 OracleXmlTypeのstaticメソッド
メソッド 説明

Equals

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

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

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

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

Connection

OracleXmlTypeのXMLデータの取得および格納に使用されるOracleConnectionを示します。

IsEmpty

OracleXmlTypeが空かどうかを示します。

IsFragment

XMLデータがXML要素のコレクションであるか、整形式XML文書であるかを示します。

IsSchemaBased

OracleXmlTypeによって表されるXMLデータがXMLスキーマに基づいているかどうかを示します。

Value

現在のインスタンスの最初の文字から始まるXMLデータをstringとして返します。

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

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

表5-190 OracleXmlTypeのインスタンス・メソッド
メソッド 説明

Clone

OracleXmlTypeインスタンスのコピーを作成します。

Dispose

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

Equals

Objectから継承されます。

Extract

指定されたXPath式を使用してXMLデータからサブセットを抽出します(オーバーロード)。

GetHashCode

Objectから継承されます。

GetStream

このOracleXmlTypeインスタンスに格納された読取り専用ストリームのXMLデータを提供するOracleXmlStreamのインスタンスを返します。

GetType

Objectから継承されます。

GetXmlDocument

このOracleXmlTypeインスタンスに格納されたXMLデータを含むXmlDocumentオブジェクトを返します。

GetXmlReader

.NET Frameworkのクラスおよびメソッドを使用してXMLデータを直接操作するために使用できるXmlTextReaderオブジェクトを返します。

IsExists

XMLデータ内で、指定されたXPath式によって識別される特定のノード・セットが存在するかどうかをチェックします(オーバーロード)。

ToString

Objectから継承されます。

Transform

指定されたXSL文書を使用してOracleXmlTypeを別のOracleXmlTypeインスタンスに変換します(オーバーロード)。

Update

現在のOracleXmlTypeインスタンス内で、指定されたXPath式によって識別されるXMLノードまたはXMLフラグメントを更新します(オーバーロード)。

関連項目:

OracleXmlTypeのコンストラクタ

OracleXmlTypeのコンストラクタは、OracleXmlTypeクラスのインスタンスを作成します。

オーバーロード一覧:

OracleXmlType(OracleClob)

このコンストラクタは、OracleClobオブジェクトに含まれるXMLデータを使用してOracleXmlTypeクラスのインスタンスを作成します。

宣言
// C#
public OracleXmlType(OracleClob oraClob);
パラメータ
例外

ArgumentNullException: OracleClobオブジェクトがnullです。

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

備考

CLOBデータは有効な接続オブジェクトによって決まります。また、新規のOracleXMLTypeは、OracleClobオブジェクトのOracleConnectionを使用して現在のインスタンスのデータを格納します。

関連項目:

OracleXmlType(OracleConnection, string)

このコンストラクタは、.NETのstringに含まれるXMLデータを使用してOracleXmlTypeクラスのインスタンスを作成します。

宣言
// C#
public OracleXmlType(OracleConnection con, string xmlData);

パラメータ
例外

ArgumentNullException: OracleConnectionオブジェクトがnullです。

ArgumentException: xmlData引数が空の文字列です。

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

備考

新規のOracleXMLTypeは、指定されたOracleConnectionオブジェクトを使用して現在のインスタンスのデータを格納します。

関連項目:

OracleXmlType(OracleConnection, XmlReader)

このコンストラクタは、.NETのXmlReaderオブジェクトの内容を使用してOracleXmlTypeクラスのインスタンスを作成します。

宣言
// C#
public OracleXmlType(OracleConnection con, XmlReader reader);
パラメータ
例外

ArgumentNullException: OracleConnectionオブジェクトがnullです。

ArgumentException: reader引数にデータが含まれていません。

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

備考

新規のOracleXMLTypeは、指定されたOracleConnectionオブジェクトを使用して現在のインスタンスのデータを格納します。

関連項目:

OracleXmlType(OracleConnection, XmlDocument)

このコンストラクタは、.NETのXmlDocumentオブジェクトに含まれるXML DOM文書の内容を使用してOracleXmlTypeオブジェクトのインスタンスを作成します。

宣言
// C#
public OracleXmlType(OracleConnection con, XmlDocument domDoc);
パラメータ
例外

ArgumentNullException: OracleConnectionオブジェクトがnullです。

ArgumentException: domDoc引数にデータが含まれていません。

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

備考

新規のOracleXMLTypeは、指定されたOracleConnectionオブジェクトを使用して現在のインスタンスのデータを格納します。

関連項目:

OracleXmlTypeのstaticメソッド

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

表5-191 OracleXmlTypeのstaticメソッド
メソッド 説明

Equals

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

関連項目:

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

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

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

Connection

OracleXmlTypeのXMLデータの取得および格納に使用されるOracleConnectionを示します。

IsEmpty

OracleXmlTypeが空かどうかを示します。

IsFragment

XMLデータがXML要素のコレクションであるか、整形式XML文書であるかを示します。

IsSchemaBased

OracleXmlTypeによって表されるXMLデータがXMLスキーマに基づいているかどうかを示します。

Value

現在のインスタンスの最初の文字から始まるXMLデータをstringとして返します。

関連項目:

Connection

このプロパティは、OracleXmlTypeのXMLデータの取得および格納に使用されるOracleConnectionを示します。

宣言
// C#
public OracleConnection Connection {get;}
プロパティ値

OracleConnectionオブジェクト

例外

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

備考

接続は、OracleXmlTypeを作成または使用する前に、ユーザーが明示的にオープンする必要があります。

関連項目:

IsEmpty

このプロパティは、OracleXmlTypeが空かどうかを示します。

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

OracleXmlTypeが空のXML文書を表す場合、trueを返します。それ以外の場合、falseを返します。

例外

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

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

関連項目:

IsFragment

このプロパティは、XMLデータがXML要素のコレクションであるか、整形式XML文書であるかを示します。

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

OracleXmlTypeオブジェクトに含まれるXMLデータがルート要素を持たないXML要素のコレクションである場合、trueを返します。それ以外の場合、falseを返します。

例外

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

関連項目:

IsSchemaBased

このプロパティは、OracleXmlTypeによって表されるXMLデータがXMLスキーマに基づいているかどうかを示します。

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

OracleXmlTypeによって表されるXMLデータがXMLスキーマに基づいている場合、trueを返します。それ以外の場合、falseを返します。

例外

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

関連項目:

Value

このプロパティは、現在のインスタンスの最初の文字から始まるXMLデータをstringとして返します。

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

stringのXMLデータ全体

例外

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

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

関連項目:

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

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

表5-193 OracleXmlTypeのインスタンス・メソッド
メソッド 説明

Clone

OracleXmlTypeインスタンスのコピーを作成します。

Dispose

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

Equals

Objectから継承されます。

Extract

指定されたXPath式を使用してXMLデータからサブセットを抽出します(オーバーロード)。

GetHashCode

Objectから継承されます。

GetStream

このOracleXmlTypeインスタンスに格納された読取り専用ストリームのXMLデータを提供するOracleXmlStreamのインスタンスを返します。

GetType

Objectから継承されます。

GetXmlDocument

このOracleXmlTypeインスタンスに格納されたXMLデータを含むXmlDocumentオブジェクトを返します。

GetXmlReader

.NET Frameworkのクラスおよびメソッドを使用してXMLデータを直接操作するために使用できるXmlTextReaderオブジェクトを返します。

IsExists

XMLデータ内で、指定されたXPath式によって識別される特定のノード・セットが存在するかどうかをチェックします(オーバーロード)。

ToString

Objectから継承されます。

Transform

指定されたXSL文書を使用してOracleXmlTypeを別のOracleXmlTypeインスタンスに変換します(オーバーロード)。

Update

現在のOracleXmlTypeインスタンス内で、指定されたXPath式によって識別されるXMLノードまたはXMLフラグメントを更新します(オーバーロード)。

関連項目:

Clone

このメソッドは、このOracleXmlTypeインスタンスのコピーを作成します。

宣言
// C#
public object Clone();
実装

ICloneable

戻り値

OracleXmlTypeオブジェクト

例外

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

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

関連項目:

Dispose

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

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

IDisposable

関連項目:

Extract

このメソッドは、指定されたXPath式を使用してXMLデータからサブセットを抽出します。

オーバーロード一覧:

Extract(string, string)

このメソッドは、指定されたXPath式および名前空間解決のための文字列パラメータを使用し、OracleXmlTypeオブジェクトによって表されるXMLデータからサブセットを抽出します。

宣言
// C#
public OracleXmlType Extract(string xpathExpr, string nsMap);
パラメータ
戻り値

OracleXmlTypeオブジェクト

例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

関連項目:

Extract(string, XmlNameSpaceManager)

このpublicメソッドは、指定されたXPath式および名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、OracleXmlTypeオブジェクトによって表されるXMLデータからサブセットを抽出します。

宣言
// C#
public OracleXmlType Extract(string xpathExpr, XmlNameSpaceManager nsMgr);
パラメータ
戻り値

OracleXmlType

例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

備考

デフォルトの名前空間は、その値が空の文字列である場合、無視されます。

関連項目:

GetStream

このpublicメソッドは、このOracleXmlTypeインスタンスに格納された読取り専用ストリームのXMLデータを提供するOracleXmlStreamのインスタンスを返します。

宣言
// C#
public Stream GetStream();
戻り値

Streamオブジェクト

例外

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

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

関連項目:

GetXmlDocument

このpublicメソッドは、このOracleXmlTypeインスタンスに格納されたXMLデータを含むXmlDocumentオブジェクトを返します。

宣言
// C#
public XmlDocument GetXmlDocument();
戻り値

XmlDocumentオブジェクト

例外

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

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

備考

XmlDocumentオブジェクトのXMLデータは、OracleXmlTypeインスタンスのXMLデータのコピーですが、変更してもOracleXmlTypeインスタンスのXMLデータは自動的には変更されません。返されるXmlDocumentインスタンスのPreserveWhitespaceプロパティはtrueに設定されています。

関連項目:

GetXmlReader

このpublicメソッドは、.NET Frameworkのクラスおよびメソッドを使用してXMLデータを直接操作するために使用できるXmlTextReaderオブジェクトを返します。

宣言
// C#
public XmlTextReader GetXmlReader();
戻り値

XmlTextReaderオブジェクト

例外

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

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

備考

XmlTextReaderは、OracleXmlTypeインスタンスに格納された読取り専用、順方向のみの表現のXMLデータです。

関連項目:

IsExists

XMLデータ内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。

オーバーロード一覧:

IsExists(string, string)

このメソッドは、名前空間解決のための文字列パラメータを使用し、現在のOracleXmlTypeインスタンスによって表されるXMLデータ内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。

宣言
// C#
public bool IsExists(string xpathExpr, string nsMap);
パラメータ
戻り値

必要なノード・セットが存在する場合、trueを返します。それ以外の場合、falseを返します。

例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

備考

デフォルトの名前空間は、その値が空の文字列である場合、無視されます。

関連項目:

IsExists(string, XmlNameSpaceManager)

このメソッドは、名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、現在のOracleXmlTypeインスタンスによって表されるXML文書内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。

宣言
// C#
public bool IsExists(string xpathExpr, XmlNameSpaceManager nsMgr);
パラメータ
戻り値

必要なノード・セットが存在する場合、trueを返します。それ以外の場合、falseを返します。

例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

備考

デフォルトの名前空間は、その値が空の文字列である場合、無視されます。

関連項目:

Transform

このメソッドは、指定されたXSL文書を使用してOracleXmlTypeを別のOracleXmlTypeインスタンスに変換します。

オーバーロード一覧:

Transform(OracleXmlType, string)

このメソッドは、指定されたXSL文書およびXSLTパラメータの文字列を使用して現在のOracleXmlTypeインスタンスを別のOracleXmlTypeインスタンスに変換します。

宣言
// C#
public OracleXmlType Transform(OracleXmlType xsldoc, string paramMap);
パラメータ
戻り値

変換されたXML文書が含まれるOracleXmlTypeオブジェクト

例外

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

ArgumentNullException: xsldocパラメータがnullです。

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

関連項目:

Transform(string, string)

このメソッドは、指定されたXSL文書およびXSLTパラメータの文字列を使用して現在のOracleXmlTypeインスタンスを別のOracleXmlTypeインスタンスに変換します。

宣言
// C#
public OracleXmlType Transform(string xsldoc, string paramMap);
パラメータ
戻り値

変換されたXML文書が含まれるOracleXmlTypeオブジェクト

例外

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

ArgumentNullException: xsldocパラメータがnullです。

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

関連項目:

Update

このメソッドは、現在のOracleXmlTypeインスタンス内で、指定されたXPath式によって識別されるXMLノードまたはXMLフラグメントを更新します。

オーバーロード一覧:

Update(string, string, string)

このメソッドは、指定された文字列値および名前空間解決のための文字列パラメータを使用し、指定されたXPath式によって識別されるXMLノードを更新します。

宣言
// C#
public void Update(string xpathExpr, string nsMap, string value);
パラメータ
例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

備考

デフォルトの名前空間は、その値が空の文字列である場合、無視されます。

関連項目:

Update(string, XmlNameSpaceManager, string)

このメソッドは、指定された文字列値および名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、指定されたXPath式によって識別されるXMLノードを更新します。

宣言
// C#
public void Update(string xpathExpr, XmlNameSpaceManager nsMgr, string value);
パラメータ
例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

備考

デフォルトの名前空間は、その値が空の文字列である場合、無視されます。

関連項目:

Update(string, string, OracleXmlType)

このメソッドは、指定されたOracleXmlType値に格納されたXMLデータおよび名前空間解決のための文字列パラメータを使用し、指定されたXPath式によって識別されるXMLノードを更新します。

宣言
// C#
public void Update(string xpathExpr, string nsMap, OracleXmlType value);
パラメータ
例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

備考

デフォルトの名前空間は、その値が空の文字列である場合、無視されます。

関連項目:

Update(string, XmlNameSpaceManager, OracleXmlType)

このメソッドは、指定されたOracleXmlType値に格納されたXMLデータおよび名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、指定されたXPath式によって識別されるXMLノードを更新します。

宣言
// C#
public void Update(string xpathExpr, XmlNameSpaceManager nsMgr, OracleXmlType
value);
パラメータ
例外

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

ArgumentNullException: xpathExprnullまたは長さが0です。

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

備考

デフォルトの名前空間は、その値が空の文字列である場合、無視されます。

関連項目:


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
索引