SmartTag

SmartTag class

Bu öğe, bir paragraf içindeki bir veya daha fazla satır içi yapı (çalıştırmalar, resimler, alanlar vb.) etrafında bir akıllı etiketin varlığını belirtir.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Yapılandırılmış Belge Etiketleri veya İçerik Kontrolü dokümantasyon makalesi.

public class SmartTag : CompositeNode

yapıcılar

İsim	Tanım
SmartTag(DocumentBase)	Yeni bir örneğini başlatır`SmartTag` class.

Özellikleri

İsim	Tanım
Count { get; }	Bu düğümün doğrudan alt öğelerinin sayısını alır.
CustomNodeId { get; set; }	Özel düğüm tanımlayıcısını belirtir.
virtual Document { get; }	Bu düğümün ait olduğu belgeyi alır.
Element { get; set; }	Belge içindeki akıllı etiketin adını belirtir.
FirstChild { get; }	Düğümün ilk çocuğunu alır.
HasChildNodes { get; }	İadeler`doğru` bu düğümün herhangi bir alt düğümü varsa.
override IsComposite { get; }	İadeler`doğru` çünkü bu düğüm alt düğümlere sahip olabilir.
LastChild { get; }	Düğümün son çocuğunu alır.
NextSibling { get; }	Bu düğümden hemen sonra gelen düğümü alır.
override NodeType { get; }	İadelerSmartTag .
ParentNode { get; }	Bu düğümün doğrudan ebeveynini alır.
PreviousSibling { get; }	Bu düğümden hemen önceki düğümü alır.
Properties { get; }	Akıllı etiket özelliklerinin bir koleksiyonu.
Range { get; }	Bir değeri döndürür`Range` Bu düğümde bulunan bir belgenin bölümünü temsil eden nesne.
Uri { get; set; }	Akıllı etiketin ad alanı URI’sini belirtir.

yöntemler

İsim	Tanım
override Accept(DocumentVisitor)	Ziyaretçi kabul eder.
AppendChild(Node)	Belirtilen düğümü, bu düğüm için alt düğümler listesinin sonuna ekler.
Clone(bool)	Düğümün bir kopyasını oluşturur.
CreateNavigator()	Düğümlerin arasında geçiş yapmak ve düğümleri okumak için kullanılabilecek gezgini oluşturur.
GetAncestor(NodeType)	Belirtilenin ilk atayı alır`NodeType` .
GetAncestor(Type)	Belirtilen nesne türünün ilk atayı alır.
GetChild(NodeType, int, bool)	Belirtilen türle eşleşen N’inci alt düğümü döndürür.
GetChildNodes(NodeType, bool)	Belirtilen türle eşleşen alt düğümlerin canlı bir koleksiyonunu döndürür.
GetEnumerator()	Bu düğümün alt düğümleri üzerindeki her stil yinelemesi için destek sağlar.
override GetText()	Bu düğümün ve tüm alt öğelerinin metnini alır.
IndexOf(Node)	Alt düğüm dizisinde belirtilen alt düğümün dizinini döndürür.
InsertAfter(Node, Node)	Belirtilen düğümü, belirtilen referans düğümünün hemen sonrasına ekler.
InsertBefore(Node, Node)	Belirtilen düğümü, belirtilen referans düğümünün hemen öncesine ekler.
NextPreOrder(Node)	Ön sipariş ağaç geçiş algoritmasına göre sonraki düğümü alır.
PrependChild(Node)	Belirtilen düğümü, bu düğüm için alt düğümler listesinin başına ekler.
PreviousPreOrder(Node)	Ön sipariş ağaç geçiş algoritmasına göre önceki düğümü alır.
Remove()	Kendini üst öğeden kaldırır.
RemoveAllChildren()	Geçerli düğümün tüm alt düğümlerini kaldırır.
RemoveChild(Node)	Belirtilen alt düğümü kaldırır.
RemoveSmartTags()	Tümünü kaldırır`SmartTag`Geçerli düğümün alt düğümleri.
SelectNodes(string)	XPath ifadesiyle eşleşen düğümlerin listesini seçer.
SelectSingleNode(string)	İlkini seçer`Node` XPath ifadesiyle eşleşen.
ToString(SaveFormat)	Düğümün içeriğini belirtilen formatta bir dizeye aktarır.
ToString(SaveOptions)	Belirtilen kaydetme seçeneklerini kullanarak düğümün içeriğini bir dizeye aktarır.

Notlar

Akıllı etiketler bir tür özel XML işaretlemesidir. Akıllı etiketler, bir belge içindeki bir çalıştırma veya çalıştırma kümesi için temel bir ad alanı/name sağlama yeteneği yoluyla belgeye müşteri tanımlı semantiğin yerleştirilmesi için bir olanak sağlar.

SmartTag bir çocuk olabilirParagraph or başka birSmartTag düğüm.

Bir akıllı etiketin içinde oluşabilecek alt düğümlerin tam listesi şunlardan oluşur: BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator ,FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , CommentRangeStart , CommentRangeEnd , SmartTag.

Örnekler

Akıllı etiketlerin nasıl oluşturulacağını gösterir.

public void Create()
{
    Document doc = new Document();

    // Microsoft Word'ün metnin bir bölümünü bir tür veri olarak tanıdığı bir belgede akıllı etiket görünür,
    // ad, tarih veya adres gibi ve onu mor noktalı alt çizgi görüntüleyen bir köprüye dönüştürür.
    SmartTag smartTag = new SmartTag(doc);

    // Akıllı etiketler, tanınan metnin tamamını içeren bileşik düğümlerdir.
    // İçeriği bu akıllı etikete manuel olarak ekleyin.
    smartTag.AppendChild(new Run(doc, "May 29, 2019"));

    // Microsoft Word yukarıdaki içerikleri tarih olarak tanıyabilir.
    // Akıllı etiketler içerdikleri veri türünü yansıtmak için "Element" özelliğini kullanır.
    smartTag.Element = "date";

    // Bazı akıllı etiket türleri, içeriklerini özel XML özelliklerine göre işler.
    smartTag.Properties.Add(new CustomXmlProperty("Day", string.Empty, "29"));
    smartTag.Properties.Add(new CustomXmlProperty("Month", string.Empty, "5"));
    smartTag.Properties.Add(new CustomXmlProperty("Year", string.Empty, "2019"));

    // Akıllı etiketin URI'sini varsayılan değere ayarlayın.
    smartTag.Uri = "urn:schemas-microsoft-com:office:smarttags";

    doc.FirstSection.Body.FirstParagraph.AppendChild(smartTag);
    doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, " is a date. "));

    // Hisse senedi takip cihazı için başka bir akıllı etiket oluşturun.
    smartTag = new SmartTag(doc);
    smartTag.Element = "stockticker";
    smartTag.Uri = "urn:schemas-microsoft-com:office:smarttags";

    smartTag.AppendChild(new Run(doc, "MSFT"));

    doc.FirstSection.Body.FirstParagraph.AppendChild(smartTag);
    doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, " is a stock ticker."));

    // Bir belge ziyaretçisi kullanarak belgemizdeki tüm akıllı etiketleri yazdırın.
    doc.Accept(new SmartTagPrinter());

    // Microsoft Word'ün eski sürümleri akıllı etiketleri destekler.
    doc.Save(ArtifactsDir + "SmartTag.Create.doc");

    // Bir belgedeki tüm akıllı etiketleri kaldırmak için "RemoveSmartTags" yöntemini kullanın.
    Assert.AreEqual(2, doc.GetChildNodes(NodeType.SmartTag, true).Count);

    doc.RemoveSmartTags();

    Assert.AreEqual(0, doc.GetChildNodes(NodeType.SmartTag, true).Count);
}

/// <summary>
/// Ziyaret edilen akıllı etiketleri ve içeriklerini yazdırır.
/// </summary>
private class SmartTagPrinter : DocumentVisitor
{
    /// <summary>
    /// Belgede bir SmartTag düğümüyle karşılaşıldığında çağrılır.
    /// </summary>
    public override VisitorAction VisitSmartTagStart(SmartTag smartTag)
    {
        Console.WriteLine($"Smart tag type: {smartTag.Element}");
        return VisitorAction.Continue;
    }

    /// <summary>
    /// SmartTag düğümünün ziyareti sonlandırıldığında çağrılır.
    /// </summary>
    public override VisitorAction VisitSmartTagEnd(SmartTag smartTag)
    {
        Console.WriteLine($"\tContents: \"{smartTag.ToString(SaveFormat.Text)}\"");

        if (smartTag.Properties.Count == 0)
        {
            Console.WriteLine("\tContains no properties");
        }
        else
        {
            Console.Write("\tProperties: ");
            string[] properties = new string[smartTag.Properties.Count];
            int index = 0;

            foreach (CustomXmlProperty cxp in smartTag.Properties)
                properties[index++] = $"\"{cxp.Name}\" = \"{cxp.Value}\"";

            Console.WriteLine(string.Join(", ", properties));
        }

        return VisitorAction.Continue;
    }
}

Ayrıca bakınız

SdtType Enum StructuredDocumentTag Class