HtmlElement Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Web sayfasının içindeki bir HTML öğesini temsil eder.

public ref class HtmlElement sealed

public sealed class HtmlElement

type HtmlElement = class

Public NotInheritable Class HtmlElement

Devralma: Object
HtmlElement

Örnekler

Aşağıdaki kod örneği, rastgele bir HTML belgesinin nasıl incelendiğini ve HTML öğelerini açıklayan bir dizenin nasıl türetildiğini ve öğelerin belgede ne kadar iç içe olduğunu belirtmek için girinti ve düzey numaralarının nasıl kullanıldığını gösterir. Bu kod örneği, uygulamanızın adlı WebBrowser1bir WebBrowser denetim barındırması gerektirir.

private void PrintDomBegin()
{
    if (webBrowser1.Document != null)
    {
        HtmlElementCollection elemColl = null;
        HtmlDocument doc = webBrowser1.Document;
        if (doc != null)
        {
            elemColl = doc.GetElementsByTagName("HTML");
            String str = PrintDom(elemColl, new System.Text.StringBuilder(), 0);
            webBrowser1.DocumentText = str;
        }
    }
}

private string PrintDom(HtmlElementCollection elemColl, System.Text.StringBuilder returnStr, Int32 depth)
{
    System.Text.StringBuilder str = new System.Text.StringBuilder();

    foreach (HtmlElement elem in elemColl)
    {
        string elemName;

        elemName = elem.GetAttribute("ID");
        if (elemName == null || elemName.Length == 0)
        {
            elemName = elem.GetAttribute("name");
            if (elemName == null || elemName.Length == 0)
            {
                elemName = "<no name>";
            }
        }

        str.Append(' ', depth * 4);
        str.Append(elemName + ": " + elem.TagName + "(Level " + depth + ")");
        returnStr.AppendLine(str.ToString());

        if (elem.CanHaveChildren)
        {
            PrintDom(elem.Children, returnStr, depth + 1);
        }

        str.Remove(0, str.Length);
    }

    return (returnStr.ToString());
}

Private Sub PrintDomBegin()
    If (WebBrowser1.Document IsNot Nothing) Then
        Dim ElemColl As HtmlElementCollection

        Dim Doc As HtmlDocument = WebBrowser1.Document
        If (Not (Doc Is Nothing)) Then
            ElemColl = Doc.GetElementsByTagName("HTML")
            Dim Str As String = PrintDom(ElemColl, New System.Text.StringBuilder(), 0)

            WebBrowser1.DocumentText = Str
        End If
    End If
End Sub

Private Function PrintDom(ByVal ElemColl As HtmlElementCollection, ByRef ReturnStr As System.Text.StringBuilder, ByVal Depth As Integer) As String
    Dim Str As New System.Text.StringBuilder()

    For Each Elem As HtmlElement In ElemColl
        Dim ElemName As String

        ElemName = Elem.GetAttribute("ID")
        If (ElemName Is Nothing Or ElemName.Length = 0) Then
            ElemName = Elem.GetAttribute("name")
            If (ElemName Is Nothing Or ElemName.Length = 0) Then
                ElemName = "<no name>"
            End If
        End If

        Str.Append(CChar(" "), Depth * 4)
        Str.Append(ElemName & ": " & Elem.TagName & "(Level " & Depth & ")")
        ReturnStr.AppendLine(Str.ToString())

        If (Elem.CanHaveChildren) Then
            PrintDom(Elem.Children, ReturnStr, Depth + 1)
        End If

        Str.Remove(0, Str.Length)
    Next

    PrintDom = ReturnStr.ToString()
End Function

Açıklamalar

HtmlElement, ve FORMgibi BODY``TABLEbir HTML belgesindeki olası öğe türlerini temsil eder. sınıfı, tüm öğelerde bulmayı bekleyebileceğiniz en yaygın özellikleri kullanıma sunar.

Çoğu öğe alt öğelere sahip olabilir: bunların altına yerleştirilmiş diğer HTML öğeleri. CanHaveChildren Belirli bir öğenin alt öğeye sahip olup olmadığını test etmek için özelliğini ve Children bunlar aracılığıyla yinelemek için koleksiyonu kullanın. özelliği, Parent geçerli öğenin iç içe yerleştirildiği değeri döndürür HtmlElement .

Genellikle, bir öğedeki özniteliği veya bir öğesindeki yöntemi gibiSRC, tarafından HtmlElementdoğrudan kullanıma sunulmayan temel öğedeki IMG özniteliklere, özelliklere ve yöntemlere Submit FORMerişmeniz gerekir. GetAttribute ve SetAttribute yöntemleri, belirli bir öğedeki herhangi bir özniteliği veya özelliği almanıza ve değiştirmenize olanak tanırkenInvokeMember, yönetilen Belge Nesne Modeli'nde (DOM) kullanıma sunulmayan yöntemlere erişim sağlar. Uygulamanızın yönetilmeyen kod izni varsa, özniteliğiyle kullanıma sunulmayan özelliklere ve yöntemlere DomElement de erişebilirsiniz.

TagName Bir öğenin belirli bir türde olup olmadığını test etmek için özelliğini kullanın.

Herhangi bir HTML belgesi çalışma zamanında değiştirilebilir. yöntemiyle HtmlDocument CreateElement yeni HtmlElement nesneler oluşturabilir ve veya InsertAdjacentElement yöntemlerini kullanarak bunları başka bir öğeye AppendChild ekleyebilirsiniz. Ayrıca öğeleri HTML etiketleri olarak oluşturabilir ve mevcut bir öğenin InnerHtml özelliğine atayabilirsiniz.

Özellikler

All	Geçerli öğenin altındaki tüm öğelerden birini HtmlElementCollection alır.
CanHaveChildren	Bu öğenin alt öğeleri olup olmadığını belirten bir değer alır.
Children	HtmlElementCollection Geçerli öğenin tüm alt öğelerini alır.
ClientRectangle	HTML belgesindeki öğenin istemci alanının sınırlarını alır.
Document	HtmlDocument Bu öğenin ait olduğu öğeyi alır.
DomElement	Bu öğe için yönetilmeyen bir arabirim işaretçisi alır.
Enabled	Kullanıcının bu öğeye veri girip giremeyeceğini alır veya ayarlar.
FirstChild	Belge ağacında bu öğenin altındaki sonraki öğeyi alır.
Id	Öğesinin tanımlandığı etiketi alır veya ayarlar.
InnerHtml	Bu öğenin altındaki HTML işaretlemesini alır veya ayarlar.
InnerText	Öğesine atanan metni alır veya ayarlar.
Name	Öğesinin adını alır veya ayarlar.
NextSibling	Belge ağacındaki bu öğeyle aynı düzeyde bir sonraki öğeyi alır.
OffsetParent	Hesaplandığı OffsetRectangle öğeyi alır.
OffsetRectangle	Öğenin üst öğeye göre konumunu alır.
OuterHtml	Geçerli öğenin HTML kodunu alır veya ayarlar.
OuterText	Geçerli öğenin metnini alır veya ayarlar.
Parent	Geçerli öğenin üst öğesini alır.
ScrollLeft	Öğenin kenarıyla içeriğinin sol kenarı arasındaki uzaklığı alır veya ayarlar.
ScrollRectangle	Öğenin kaydırılabilir bölgesinin boyutlarını alır.
ScrollTop	Öğenin kenarıyla içeriğinin üst kenarı arasındaki uzaklığı alır veya ayarlar.
Style	Geçerli öğe için noktalı virgülle ayrılmış stil listesini alır veya ayarlar.
TabIndex	Bu öğenin konumunu sekme sırasına göre alır veya ayarlar.
TagName	HTML etiketinin adını alır.

Yöntemler

AppendChild(HtmlElement)	Bir öğeyi başka bir öğenin alt ağacına ekler.
AttachEventHandler(String, EventHandler)	HTML Belge Nesne Modeli'ne (DOM) adlandırılmış bir olay için olay işleyicisi ekler.
DetachEventHandler(String, EventHandler)	HTML Belge Nesne Modeli'nin (DOM) adlandırılmış olayından olay işleyicisini kaldırır.
Equals(Object)	Sağlanan nesnenin geçerli öğeye eşit olup olmadığını sınar.
Focus()	Kullanıcı giriş odağını geçerli öğeye yerleştirir.
GetAttribute(String)	öğesindeki adlandırılmış özniteliğin değerini alır.
GetElementsByTagName(String)	`Belirtilen HTML` etiketi tarafından HTML'de temsil edilen öğe koleksiyonunu alır.
GetHashCode()	Belirli bir tür için karma işlevi olarak görev yapar.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)	Belge Nesne Modeli'ne (DOM) yeni bir öğe ekleyin.
InvokeMember(String)	Bu öğenin temel alınan DOM öğesinde kullanıma sunulmamış bir yöntem yürütür.
InvokeMember(String, Object[])	Geçerli HTML sayfasında betik diliyle tanımlanan bir işlevi yürütür.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RaiseEvent(String)	Adlandırılmış olayın tüm kayıtlı olay işleyicilerini çağırmasına neden olur.
RemoveFocus()	Geçerli öğede odak varsa, odağı geçerli öğeden kaldırır.
ScrollIntoView(Boolean)	Bu öğenin üst veya alt kenarı belgenin penceresiyle hizalanana kadar bu öğeyi içeren belgeyi kaydırarak ilerler.
SetAttribute(String, String)	öğesinde adlandırılmış özniteliğin değerini ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

İşleçler

Equality(HtmlElement, HtmlElement)	Eşitlik için iki öğeyi karşılaştırır.
Inequality(HtmlElement, HtmlElement)	Eşitsizlik için iki HtmlElement nesneyi karşılaştırır.

Ekinlikler

Click	Kullanıcı sol fare düğmesiyle öğeye tıkladığında gerçekleşir.
DoubleClick	Kullanıcı bir öğenin üzerinde sol fare düğmesine iki kez tıkladığında, hızlı bir şekilde gerçekleşir.
Drag	Kullanıcı metni çeşitli konumlara sürüklediğinde gerçekleşir.
DragEnd	Kullanıcı sürükleme işlemini tamamladığında gerçekleşir.
DragLeave	Kullanıcı artık bir öğeyi bu öğenin üzerine sürüklemediğinde gerçekleşir.
DragOver	Kullanıcı öğenin üzerine metin sürüklediğinde gerçekleşir.
Focusing	öğesi kullanıcı giriş odağını ilk kez aldığında gerçekleşir.
GotFocus	öğesi kullanıcı giriş odağını aldığında gerçekleşir.
KeyDown	Kullanıcı klavyedeki bir tuşa bastığında gerçekleşir.
KeyPress	Kullanıcı klavyedeki bir tuşa basıp bıraktığında gerçekleşir.
KeyUp	Kullanıcı klavyede bir tuş bıraktığında gerçekleşir.
LosingFocus	öğesi kullanıcı giriş odağını kaybettiğinde gerçekleşir.
LostFocus	öğesi kullanıcı giriş odağını kaybettiğinde gerçekleşir.
MouseDown	Kullanıcı fare düğmesine bastığında gerçekleşir.
MouseEnter	Kullanıcı fare imlecini geçerli öğenin üzerine ilk kez hareket ettirdiğinde gerçekleşir.
MouseLeave	Kullanıcı fare imlecini geçerli öğenin dışına hareket ettirdiğinde gerçekleşir.
MouseMove	Kullanıcı fare imlecini öğenin üzerinde hareket ettirdiğinde gerçekleşir.
MouseOver	Fare imleci öğenin sınırlarına girdiğinde gerçekleşir.
MouseUp	Kullanıcı fare düğmesini serbest bıraktığında gerçekleşir.

Şunlara uygulanır