HtmlElement Sınıf
Tanım
Ö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
-
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ı WebBrowser1
bir 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 FORM
gibi BODY``TABLE
bir 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
FORM
eriş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 HtmlDocumentCreateElement 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) |
|
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. |