| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、19/19
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のコンストラクタを表5-187に示します。
| コンストラクタ | 説明 |
|---|---|
|
|
OracleXmlTypeのstaticメソッドを表5-188に示します。
| メソッド | 説明 |
|---|---|
|
|
|
OracleXmlTypeのインスタンス・プロパティを表5-189に示します。
OracleXmlTypeのインスタンス・メソッドを表5-190に示します。
OracleXmlTypeのコンストラクタは、OracleXmlTypeクラスのインスタンスを作成します。
このコンストラクタは、OracleClobオブジェクトに含まれるXMLデータを使用してOracleXmlTypeクラスのインスタンスを作成します。
このコンストラクタは、.NETのstringに含まれるXMLデータを使用してOracleXmlTypeクラスのインスタンスを作成します。
このコンストラクタは、.NETのXmlReaderオブジェクトの内容を使用してOracleXmlTypeクラスのインスタンスを作成します。
このコンストラクタは、.NETのXmlDocumentオブジェクトに含まれるXML DOM文書の内容を使用してOracleXmlTypeオブジェクトのインスタンスを作成します。
このコンストラクタは、OracleClobオブジェクトに含まれるXMLデータを使用してOracleXmlTypeクラスのインスタンスを作成します。
// C# public OracleXmlType(OracleClob oraClob);
ArgumentNullException: OracleClobオブジェクトがnullです。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
CLOBデータは有効な接続オブジェクトによって決まります。また、新規のOracleXMLTypeは、OracleClobオブジェクトのOracleConnectionを使用して現在のインスタンスのデータを格納します。
このコンストラクタは、.NETのstringに含まれるXMLデータを使用してOracleXmlTypeクラスのインスタンスを作成します。
// C# public OracleXmlType(OracleConnection con, string xmlData);
ArgumentNullException: OracleConnectionオブジェクトがnullです。
ArgumentException: xmlData引数が空の文字列です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
新規のOracleXMLTypeは、指定されたOracleConnectionオブジェクトを使用して現在のインスタンスのデータを格納します。
このコンストラクタは、.NETのXmlReaderオブジェクトの内容を使用してOracleXmlTypeクラスのインスタンスを作成します。
// C# public OracleXmlType(OracleConnection con, XmlReader reader);
ArgumentNullException: OracleConnectionオブジェクトがnullです。
ArgumentException: reader引数にデータが含まれていません。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
新規のOracleXMLTypeは、指定されたOracleConnectionオブジェクトを使用して現在のインスタンスのデータを格納します。
このコンストラクタは、.NETのXmlDocumentオブジェクトに含まれるXML DOM文書の内容を使用してOracleXmlTypeオブジェクトのインスタンスを作成します。
// C# public OracleXmlType(OracleConnection con, XmlDocument domDoc);
ArgumentNullException: OracleConnectionオブジェクトがnullです。
ArgumentException: domDoc引数にデータが含まれていません。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
新規のOracleXMLTypeは、指定されたOracleConnectionオブジェクトを使用して現在のインスタンスのデータを格納します。
OracleXmlTypeのstaticメソッドを表5-191に示します。
| メソッド | 説明 |
|---|---|
|
|
|
OracleXmlTypeのインスタンス・プロパティを表5-192に示します。
このプロパティは、OracleXmlTypeのXMLデータの取得および格納に使用されるOracleConnectionを示します。
// C# public OracleConnection Connection {get;}
OracleConnectionオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
接続は、OracleXmlTypeを作成または使用する前に、ユーザーが明示的にオープンする必要があります。
このプロパティは、OracleXmlTypeが空かどうかを示します。
// C# public bool IsEmpty {get;}
OracleXmlTypeが空のXML文書を表す場合、trueを返します。それ以外の場合、falseを返します。
ObjectDisposedException: オブジェクトがすでに破棄されています。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
このプロパティは、XMLデータがXML要素のコレクションであるか、整形式XML文書であるかを示します。
// C# public bool IsFragment {get;}
OracleXmlTypeオブジェクトに含まれるXMLデータがルート要素を持たないXML要素のコレクションである場合、trueを返します。それ以外の場合、falseを返します。
ObjectDisposedException: オブジェクトがすでに破棄されています。
このプロパティは、OracleXmlTypeによって表されるXMLデータがXMLスキーマに基づいているかどうかを示します。
// C# public bool IsSchemaBased {get;}
OracleXmlTypeによって表されるXMLデータがXMLスキーマに基づいている場合、trueを返します。それ以外の場合、falseを返します。
ObjectDisposedException: オブジェクトがすでに破棄されています。
このプロパティは、現在のインスタンスの最初の文字から始まるXMLデータをstringとして返します。
// C# public string RootElement{get;}
stringのXMLデータ全体
ObjectDisposedException: オブジェクトがすでに破棄されています。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
OracleXmlTypeのインスタンス・メソッドを表5-193に示します。
このメソッドは、このOracleXmlTypeインスタンスのコピーを作成します。
// C# public object Clone();
ICloneable
OracleXmlTypeオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
このメソッドは、このオブジェクトによって割り当てられたリソースを解放します。
// C# public void Dispose();
IDisposable
このメソッドは、指定されたXPath式を使用してXMLデータからサブセットを抽出します。
このメソッドは、指定されたXPath式および名前空間解決のための文字列パラメータを使用し、OracleXmlTypeオブジェクトによって表されるXMLデータからサブセットを抽出します。
このメソッドは、指定されたXPath式および名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、OracleXmlTypeオブジェクトによって表されるXMLデータからサブセットを抽出します。
このメソッドは、指定されたXPath式および名前空間解決のための文字列パラメータを使用し、OracleXmlTypeオブジェクトによって表されるXMLデータからサブセットを抽出します。
// C# public OracleXmlType Extract(string xpathExpr, string nsMap);
xpathExpr
XPath式。
nsMap
XPath式の名前空間解決に使用される文字列パラメータ。nsMapには空白で区切られた0個以上の名前空間が含まれます。nsMapはnullでもかまいません。次に例を示します。
xmlns:nsi"=http://www.company1.com" xmlns:nsz="http://www.company2.com"
OracleXmlTypeオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
このpublicメソッドは、指定されたXPath式および名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、OracleXmlTypeオブジェクトによって表されるXMLデータからサブセットを抽出します。
// C# public OracleXmlType Extract(string xpathExpr, XmlNameSpaceManager nsMgr);
OracleXmlType
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
デフォルトの名前空間は、その値が空の文字列である場合、無視されます。
このpublicメソッドは、このOracleXmlTypeインスタンスに格納された読取り専用ストリームのXMLデータを提供するOracleXmlStreamのインスタンスを返します。
// C# public Stream GetStream();
Streamオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
このpublicメソッドは、このOracleXmlTypeインスタンスに格納されたXMLデータを含むXmlDocumentオブジェクトを返します。
// C# public XmlDocument GetXmlDocument();
XmlDocumentオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
XmlDocumentオブジェクトのXMLデータは、OracleXmlTypeインスタンスのXMLデータのコピーですが、変更してもOracleXmlTypeインスタンスのXMLデータは自動的には変更されません。返されるXmlDocumentインスタンスのPreserveWhitespaceプロパティはtrueに設定されています。
このpublicメソッドは、.NET Frameworkのクラスおよびメソッドを使用してXMLデータを直接操作するために使用できるXmlTextReaderオブジェクトを返します。
// C# public XmlTextReader GetXmlReader();
XmlTextReaderオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
XmlTextReaderは、OracleXmlTypeインスタンスに格納された読取り専用、順方向のみの表現のXMLデータです。
XMLデータ内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。
このメソッドは、名前空間解決のための文字列パラメータを使用し、現在のOracleXmlTypeインスタンスによって表されるXMLデータ内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。
このメソッドは、名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、現在のOracleXmlTypeインスタンスによって表されるXML文書内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。
このメソッドは、名前空間解決のための文字列パラメータを使用し、現在のOracleXmlTypeインスタンスによって表されるXMLデータ内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。
// C# public bool IsExists(string xpathExpr, string nsMap);
xpathExpr
XPath式。
nsMap
XPath式の名前空間解決に使用される文字列パラメータ。nsMapには空白で区切られた0個以上の名前空間が含まれます。nsMapはnullでもかまいません。
必要なノード・セットが存在する場合、trueを返します。それ以外の場合、falseを返します。
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
デフォルトの名前空間は、その値が空の文字列である場合、無視されます。
このメソッドは、名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、現在のOracleXmlTypeインスタンスによって表されるXML文書内で、XPath式によって識別される特定のノード・セットが存在するかどうかをチェックします。
// C# public bool IsExists(string xpathExpr, XmlNameSpaceManager nsMgr);
必要なノード・セットが存在する場合、trueを返します。それ以外の場合、falseを返します。
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
デフォルトの名前空間は、その値が空の文字列である場合、無視されます。
このメソッドは、指定されたXSL文書を使用してOracleXmlTypeを別のOracleXmlTypeインスタンスに変換します。
このメソッドは、指定されたXSL文書(OracleXmlTypeオブジェクト)およびXSLTパラメータの文字列を使用し、現在のOracleXmlTypeインスタンスを別のOracleXmlTypeインスタンスに変換します。
このpublicメソッドは、指定されたXSL文書およびXSLTパラメータの文字列を使用し、現在のOracleXmlTypeインスタンスを別のOracleXmlTypeインスタンスに変換します。
このメソッドは、指定されたXSL文書およびXSLTパラメータの文字列を使用して現在のOracleXmlTypeインスタンスを別のOracleXmlTypeインスタンスに変換します。
// C# public OracleXmlType Transform(OracleXmlType xsldoc, string paramMap);
変換されたXML文書が含まれるOracleXmlTypeオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xsldocパラメータがnullです。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
このメソッドは、指定されたXSL文書およびXSLTパラメータの文字列を使用して現在のOracleXmlTypeインスタンスを別のOracleXmlTypeインスタンスに変換します。
// C# public OracleXmlType Transform(string xsldoc, string paramMap);
変換されたXML文書が含まれるOracleXmlTypeオブジェクト
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xsldocパラメータがnullです。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
このメソッドは、現在のOracleXmlTypeインスタンス内で、指定されたXPath式によって識別されるXMLノードまたはXMLフラグメントを更新します。
このメソッドは、指定された文字列値および名前空間解決のための文字列パラメータを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
このメソッドは、指定された文字列値および名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
このメソッドは、指定されたOracleXmlType値に格納されたXMLデータおよび名前空間解決のための文字列パラメータを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
このメソッドは、指定されたOracleXmlType値に格納されたXMLデータおよび名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
このメソッドは、指定された文字列値および名前空間解決のための文字列パラメータを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
// C# public void Update(string xpathExpr, string nsMap, string value);
xpathExpr
更新するノードを識別するXPath式。
nsMap
XPath式の名前空間解決に使用される文字列パラメータ。nsMapには空白で区切られた0個以上の名前空間が含まれます。nsMapはnullでもかまいません。次に例を示します。
xmlns:nsi"=http://www.company1.com" xmlns:nsz="http://www.company2.com"
value
stringの新しい値。
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
デフォルトの名前空間は、その値が空の文字列である場合、無視されます。
このメソッドは、指定された文字列値および名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
// C# public void Update(string xpathExpr, XmlNameSpaceManager nsMgr, string value);
xpathExpr
更新するノードを識別するXPath式。
nsMgr
XPath式の名前空間解決に使用される.NETのXmlNameSpaceManagerオブジェクト。nsMgrはnullでもかまいません。
value
stringの新しい値。
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
デフォルトの名前空間は、その値が空の文字列である場合、無視されます。
このメソッドは、指定されたOracleXmlType値に格納されたXMLデータおよび名前空間解決のための文字列パラメータを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
// C# public void Update(string xpathExpr, string nsMap, OracleXmlType value);
xpathExpr
更新するノードを識別するXPath式。
nsMap
XPath式の名前空間解決に使用される文字列パラメータ。nsMapには空白で区切られた0個以上の名前空間が含まれます。nsMapはnullでもかまいません。
value
OracleXmlTypeオブジェクトの新しい値。
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
デフォルトの名前空間は、その値が空の文字列である場合、無視されます。
このメソッドは、指定されたOracleXmlType値に格納されたXMLデータおよび名前空間解決のための.NETのXmlNameSpaceManagerオブジェクトを使用し、指定されたXPath式によって識別されるXMLノードを更新します。
// C# public void Update(string xpathExpr, XmlNameSpaceManager nsMgr, OracleXmlType value);
xpathExpr
更新するノードを識別するXPath式。
nsMgr
XPath式の名前空間解決に使用される.NETのXmlNameSpaceManagerオブジェクト。nsMgrはnullでもかまいません。
value
OracleXmlTypeオブジェクトの新しい値。
ObjectDisposedException: オブジェクトがすでに破棄されています。
ArgumentNullException: xpathExprがnullまたは長さが0です。
InvalidOperationException: OracleConnectionがオープンされていないか、オブジェクトの存続期間中にクローズされました。
デフォルトの名前空間は、その値が空の文字列である場合、無視されます。
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|