HtmlWindowCollection Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Représente les fenêtres contenues dans un autre HtmlWindow.

public ref class HtmlWindowCollection : System::Collections::ICollection

public class HtmlWindowCollection : System.Collections.ICollection

type HtmlWindowCollection = class
    interface ICollection
    interface IEnumerable

Public Class HtmlWindowCollection
Implements ICollection

Héritage

Object

HtmlWindowCollection

Implémente

ICollection IEnumerable

Exemples

L’exemple de code suivant inspecte chaque document d’une page contenant des cadres et crée une table de tous les liens hypertexte sortants de chaque page pour une inspection ultérieure.

private void GetLinksFromFrames()
{
    Hashtable linksTable = new Hashtable();
    string frameUrl;

    if (!(webBrowser1.Document == null))
    {
        HtmlWindow currentWindow = webBrowser1.Document.Window;
        if (currentWindow.Frames.Count > 0)
        {
            foreach (HtmlWindow frame in currentWindow.Frames)
            {
                frameUrl = frame.Url.ToString();
                Hashtable frameLinksHash = new Hashtable();

                linksTable.Add(frameUrl, frameLinksHash);
                foreach (HtmlElement hrefElement in frame.Document.Links)
                {
                    frameLinksHash.Add(hrefElement.GetAttribute("HREF"), "Url");
                }
            }
        }
        else
        {
            Hashtable docLinksHash = new Hashtable();
            linksTable.Add(webBrowser1.Document.Url.ToString(), docLinksHash);

            foreach (HtmlElement hrefElement in webBrowser1.Document.Links)
            {
                docLinksHash.Add(hrefElement.GetAttribute("HREF"), "Url");
            }
        }
    }
}

Dim LinksTable As Hashtable

Private Sub GetLinksFromFrames()
    LinksTable = New Hashtable()
    Dim FrameUrl As String

    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            Dim CurrentWindow As HtmlWindow = .Window
            If (CurrentWindow.Frames.Count > 0) Then
                For Each Frame As HtmlWindow In CurrentWindow.Frames
                    FrameUrl = Frame.Url.ToString()
                    Dim FrameLinksHash As New Hashtable()
                    LinksTable.Add(FrameUrl, FrameLinksHash)

                    For Each HrefElement As HtmlElement In Frame.Document.Links
                        FrameLinksHash.Add(HrefElement.GetAttribute("HREF"), "Url")
                    Next
                Next
            Else
                Dim DocLinksHash As New Hashtable()
                LinksTable.Add(.Url.ToString(), DocLinksHash)

                For Each HrefElement As HtmlElement In .Links
                    DocLinksHash.Add(HrefElement.GetAttribute("HREF"), "Url")
                Next
            End If
        End With
    End If
End Sub

Remarques

Un document HTML peut être constitué d’un FRAMESET qui définit plusieurs objets fixes FRAME , chacun contenant sa propre page HTML. Un document peut également contenir un certain nombre d’objets IFRAME , qui peuvent placer des documents arbitrairement à l’intérieur d’autres documents. FRAME Les objets et IFRAME les objets sont représentés à leur niveau supérieur par un HtmlWindowCollection, qui contient des éléments de type HtmlWindow.

HtmlWindowCollection prend en charge l’interface IEnumerator afin qu’elle puisse être utilisée dans les constructions de boucle. Il définit également une méthode Item, qui permet d’accéder aux éléments de la collection via un appel de méthode ou à l’aide de la syntaxe de tableau standard.

Si vous créez des fenêtres avec les Open méthodes ou OpenNew et que les documents hébergés par ces fenêtres contiennent des FRAME éléments ou IFRAME , ces éléments apparaissent dans la HtmlWindowCollection page parente.

Pour plus d’informations sur les frames, consultez la documentation de la Frames propriété .

Propriétés

Count	Obtient le nombre d’éléments de la collection.
Item[Int32]	Récupère une fenêtre frame en fournissant la position du frame dans la collection.
Item[String]	Récupère une fenêtre frame en fournissant le nom du frame.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un énumérateur qui peut itérer au sein de tous les éléments dans HtmlWindowCollection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Copie les éléments de la collection dans un Array, en commençant à un index particulier de Array.
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.

Méthodes d’extension

Voir aussi

• IHTMLFramesCollection2, interface