Document Yapı

Tanım

Ad Alanı:

System.Reflection.Metadata

Bütünleştirilmiş Kod:

System.Reflection.Metadata.dll

Paket:

System.Reflection.Metadata v11.0.0-preview.5.26302.115

Kaynak:

Document.cs

Hata ayıklama meta verilerindeki kaynak belge.

public value class Document

public readonly struct Document

type Document = struct

Public Structure Document

Devralma

Object

ValueType

Document

Örnekler

Bu örnekte, Taşınabilir PDB dosyasında kaynak belgeler hakkındaki bilgilerin nasıl görüntüleneceği gösterilmektedir:

static string ReadDocumentPath(MetadataReader reader, Document doc)
{
    BlobReader blob = reader.GetBlobReader(doc.Name);

    // Read path separator character
    var separator = (char)blob.ReadByte();
    var sb = new StringBuilder(blob.Length * 2);

    // Read path segments
    while (true)
    {
        BlobHandle bh = blob.ReadBlobHandle();

        if (!bh.IsNil)
        {
            byte[] nameBytes = reader.GetBlobBytes(bh);
            sb.Append(Encoding.UTF8.GetString(nameBytes));
        }

        if (blob.Offset >= blob.Length) break;

        sb.Append(separator);
    }

    return sb.ToString();
}

public static void ReadPdbDocuments(string pdbPath)
{
    // Open Portable PDB file
    using var fs = new FileStream(pdbPath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
    using MetadataReaderProvider provider = MetadataReaderProvider.FromPortablePdbStream(fs);
    
    MetadataReader reader = provider.GetMetadataReader();

    // Display information about documents in each MethodDebugInformation table entry
    foreach (MethodDebugInformationHandle h in reader.MethodDebugInformation)
    {
        MethodDebugInformation mdi = reader.GetMethodDebugInformation(h);

        if (mdi.Document.IsNil) continue;

        int token = MetadataTokens.GetToken(h);
        Console.WriteLine($"MethodDebugInformation 0x{token.ToString("X")}");

        Document doc = reader.GetDocument(mdi.Document);
        Console.WriteLine($"File: {ReadDocumentPath(reader, doc)}");
        Guid guidLang = reader.GetGuid(doc.Language);
        Console.WriteLine($"Language: {guidLang}");
        Guid guidHashAlg = reader.GetGuid(doc.HashAlgorithm);
        Console.WriteLine($"Hash algorithm: {guidHashAlg}");
        Console.WriteLine();
    }
}

Açıklamalar

Daha fazla bilgi için bkz . Taşınabilir PDB v1.0: Biçim Belirtimi.

Özellikler

Name	Description
Hash	Belge içerik karması alır.
HashAlgorithm	öğesini hesaplamak için kullanılan karma algoritmayı Hash alır (örneğin, SHA-1 veya SHA-256).
Language	Kaynak kod dilini (C#, VB, F# vb.) alır.
Name	Belge adı blobunu alır.