HtmlElement.InsertAdjacentElement メソッド

.NET Framework クラス ライブラリ リファレンス

HtmlElement.InsertAdjacentElement メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

新しい要素を DOM に挿入します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function InsertAdjacentElement ( _
    orient As HtmlElementInsertionOrientation, _
    newElement As HtmlElement _
) As HtmlElement

Visual Basic (使用法)

Dim instance As HtmlElement
Dim orient As HtmlElementInsertionOrientation
Dim newElement As HtmlElement
Dim returnValue As HtmlElement

returnValue = instance.InsertAdjacentElement(orient, newElement)

C#

public HtmlElement InsertAdjacentElement (
    HtmlElementInsertionOrientation orient,
    HtmlElement newElement
)

C++

public:
HtmlElement^ InsertAdjacentElement (
    HtmlElementInsertionOrientation orient, 
    HtmlElement^ newElement
)

J#

public HtmlElement InsertAdjacentElement (
    HtmlElementInsertionOrientation orient, 
    HtmlElement newElement
)

JScript

public function InsertAdjacentElement (
    orient : HtmlElementInsertionOrientation, 
    newElement : HtmlElement
) : HtmlElement

パラメータ

orient

現在の要素を基準とした、この要素の挿入位置。

newElement

挿入する新しい要素。

戻り値
挿入された HtmlElement。挿入が失敗した場合は null 参照 (Visual Basic では Nothing) を返します。

解説

このメソッドは、WebBrowser コントロールの DocumentCompleted イベントが発生するまで呼び出さないでください。その前にこのメソッドを呼び出すと、ドキュメントの読み込みが終了していないため、例外がスローされます。

HtmlElementInsertionOrientation の値が有効であるかどうかは、要素の種類によって異なります。たとえば、AfterBegin は DIV 要素については有効ですが、SCRIPT 要素と IMG 要素については有効ではありません。これは、これらの要素がどちらも子要素を持つことができないからです。

使用例

次のコード例では、ユーザーが ADatum.com サーバー以外から表示するすべてのページの最上部に、DIV 要素を挿入します。この例では、フォームに WebBrowser1 という名前の WebBrowser コントロールが含まれている必要があります。また、名前空間 System.Text.RegularExpressions をインポートする必要もあります。

C#

public void AddDivMessage()
{
    Uri currentUri = new Uri(webBrowser1.Url.ToString());
    String hostName = null;

    // Ensure we have a host name, and not just an IP, against which
 to test.
    if (!(currentUri.HostNameType == UriHostNameType.Dns))
    {
        DnsPermission permit = new DnsPermission(System.Security.Permissions.PermissionState.Unrestricted);
        permit.Assert();

        IPHostEntry hostEntry = System.Net.Dns.GetHostEntry(currentUri.Host);
        hostName = hostEntry.HostName;
    } else {
        hostName = currentUri.Host;
    }

    if (!hostName.Contains("adatum.com"))
    {
        AddTopPageMessage("You are viewing a web site other than ADatum.com.
 " +
            "Please exercise caution, and ensure your Web surfing complies with
 all " +
            "corporate regulations as laid out in the company
 handbook.");
    }
}

private void AddTopPageMessage(String message)
{
    if (webBrowser1.Document != null) 
    {
        HtmlDocument doc = webBrowser1.Document;

        // Do not insert the warning again if it already exists. 
        HtmlElementCollection returnedElems = doc.All.GetElementsByName("ADatumWarningDiv");
        if ((returnedElems != null) &&
 (returnedElems.Count > 0)) 
        {
            return;
        }

        HtmlElement divElem = doc.CreateElement("DIV");
        divElem.Name = "ADatumWarningDiv";
        divElem.Style = "background-color:black;color:white;font-weight:bold;width:100%;";
        divElem.InnerText = message;

        divElem = doc.Body.InsertAdjacentElement(HtmlElementInsertionOrientation.AfterBegin,
 divElem);
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HtmlElement クラス
HtmlElement メンバ
System.Windows.Forms 名前空間
その他の技術情報
insertAdjacentElement Method