ISymbolDocumentWriter Интерфейс

Определение

Пространство имен:

System.Diagnostics.SymbolStore

Сборки:

netstandard.dll, System.Diagnostics.StackTrace.dll

Исходный код:

ISymbolDocumentWriter.cs

Представляет документ, на который ссылается хранилище символов.

public interface class ISymbolDocumentWriter

public interface ISymbolDocumentWriter

type ISymbolDocumentWriter = interface

Public Interface ISymbolDocumentWriter

Производный

System.Diagnostics.SymbolStore.SymDocumentWriter

Примеры

В следующем примере кода показано, как ISymbolDocumentWriter можно получить при вызове DefineDocument.

using System;
using System.Reflection;
using System.Reflection.Emit;
using System.Resources;
using System.Diagnostics.SymbolStore;

namespace ILGenServer
{
   public class CodeGenerator
   {
      ModuleBuilder myModuleBuilder ;
      AssemblyBuilder myAssemblyBuilder ;

      public CodeGenerator()
      {

         // Get the current application domain for the current thread.
         AppDomain currentDomain = AppDomain.CurrentDomain;
         AssemblyName myAssemblyName = new AssemblyName();
         myAssemblyName.Name = "TempAssembly";

         // Define a dynamic assembly in the current domain.
         myAssemblyBuilder =
            currentDomain.DefineDynamicAssembly
                        (myAssemblyName, AssemblyBuilderAccess.RunAndSave);
         // Define a dynamic module in "TempAssembly" assembly.
         myModuleBuilder =
            myAssemblyBuilder.DefineDynamicModule("TempModule","Resource.mod",true);

         // Define a document for source.on 'TempModule' module.
         ISymbolDocumentWriter myDocument =
         myModuleBuilder.DefineDocument("RTAsm.il", SymDocumentType.Text,
                  SymLanguageType.ILAssembly,SymLanguageVendor.Microsoft);

         Console.WriteLine("The object representing the defined document is:"+myDocument);
      }
   }
   public class CallerClass
   {
      public static void Main()
      {
         CodeGenerator myGenerator = new CodeGenerator();
      }
   }
}

Imports System.Reflection
Imports System.Reflection.Emit
Imports System.Resources
Imports System.Diagnostics.SymbolStore

Namespace ILGenServer

   Public Class CodeGenerator
      Private myModuleBuilder As ModuleBuilder
      Private myAssemblyBuilder As AssemblyBuilder

      Public Sub New()

         ' Get the current application domain for the current thread.
         Dim currentDomain As AppDomain = AppDomain.CurrentDomain
         Dim myAssemblyName As New AssemblyName()
         myAssemblyName.Name = "TempAssembly"

         ' Define a dynamic assembly in the current domain.
         myAssemblyBuilder = currentDomain.DefineDynamicAssembly(myAssemblyName, _
                                                         AssemblyBuilderAccess.RunAndSave)
         ' Define a dynamic module in "TempAssembly" assembly.
         myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule", "Resource.mod", True)

         ' Define a document for source.on 'TempModule' module.
         Dim myDocument As ISymbolDocumentWriter = myModuleBuilder.DefineDocument("RTAsm.il", _
                     SymDocumentType.Text, SymLanguageType.ILAssembly, SymLanguageVendor.Microsoft)
         Console.WriteLine("The object representing the defined document is:" + _
                                                             CObj(myDocument).ToString())

      End Sub
   End Class

   Public Class CallerClass

      Public Shared Sub Main()
         Dim myGenerator As New CodeGenerator()
      End Sub
   End Class
End Namespace 'ILGenServer

Комментарии

Документ определяется URL-адресом и идентификатором GUID типа документа. При необходимости источник документа может храниться в хранилище символов.

Note

Этот интерфейс является управляемым аналогом ISymUnmanagedDocumentWriter интерфейса, который является одним из неуправляемых интерфейсов хранилища символов, которые предоставляют альтернативный способ чтения и записи сведений о символах отладки.

Методы

Имя	Описание
SetCheckSum(Guid, Byte[])	Задает сведения о контрольной сумме.
SetSource(Byte[])	Сохраняет необработанный источник для документа в хранилище символов.

См. также раздел

• ISymbolWriter
• MarkSequencePoint(ISymbolDocumentWriter, Int32, Int32, Int32, Int32)
• DefineDocument(String, Guid, Guid, Guid)