Questa documentazione è stata archiviata e non viene gestita.

Metodo HtmlElement.InsertAdjacentElement

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Inserisce un nuovo elemento nel DOM (Document Object Model).

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

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

Parametri

orient

Posizione in cui viene inserito questo elemento in relazione all'elemento corrente.

newElement

Nuovo elemento da inserire.

Valore restituito

Oggetto HtmlElement appena inserito. Se l'inserimento ha esito negativo, verrà restituito il valore riferimento null (Nothing in Visual Basic).

Non chiamare questo metodo fino a quando non si è verificato l'evento DocumentCompleted sul controllo WebBrowser. La chiamata del metodo prima del verificarsi dell'evento può generare un'eccezione, poiché il documento non è ancora stato completamente caricato.

La validità o meno di un valore di HtmlElementInsertionOrientation dipenderà dal tipo di elemento. Ad esempio, AfterBegin è valido nel caso di un elemento DIV, mentre non è valido nel caso di un elemento SCRIPT o IMG, poiché nessuno dei due può contenere elementi figlio.

Nell'esempio di codice riportato di seguito viene inserito un elemento DIV nella parte iniziale di ciascuna pagina visualizzata dagli utenti all'esterno del server ADatum.com. Per eseguire l'esempio è necessario che nel form sia presente un controllo WebBrowser denominato WebBrowser1. È inoltre necessario importare lo spazio dei nomi System.Text.RegularExpressions.

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 per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0
Mostra: