Regex.CompileToAssembly 方法

参考

定义

命名空间:: System.Text.RegularExpressions

程序集:: System.Text.RegularExpressions.dll

程序集:: System.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编译正则表达式，并将其保存到单个程序集的磁盘中。

重载

CompileToAssembly(RegexCompilationInfo[], AssemblyName)	已过时。将一个或多个指定的 Regex 对象编译为命名程序集。
CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[])	已过时。将一个或多个指定的 Regex 对象编译为具有指定特性的命名程序集。
CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String)	已过时。将一个或多个指定的 Regex 对象和一个指定的资源文件编译为具有指定特性的命名程序集。

注解

备注

在 .NET Core 和 .NET 5+ 上 Regex.CompileToAssembly ，对方法的调用将引发一个 PlatformNotSupportedException。不支持写出程序集。

CompileToAssembly(RegexCompilationInfo[], AssemblyName)

注意

Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.

将一个或多个指定的 Regex 对象编译为命名程序集。

public:
 static void CompileToAssembly(cli::array <System::Text::RegularExpressions::RegexCompilationInfo ^> ^ regexinfos, System::Reflection::AssemblyName ^ assemblyname);

public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname);

[System.Obsolete("Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.", DiagnosticId="SYSLIB0036", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname);

static member CompileToAssembly : System.Text.RegularExpressions.RegexCompilationInfo[] * System.Reflection.AssemblyName -> unit

[<System.Obsolete("Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.", DiagnosticId="SYSLIB0036", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member CompileToAssembly : System.Text.RegularExpressions.RegexCompilationInfo[] * System.Reflection.AssemblyName -> unit

Public Shared Sub CompileToAssembly (regexinfos As RegexCompilationInfo(), assemblyname As AssemblyName)

参数

regexinfos: RegexCompilationInfo[]

描述要编译的正则表达式的数组。

assemblyname: AssemblyName

程序集的文件名。

属性: ObsoleteAttribute

例外

ArgumentException

assemblyname 参数的 Name 属性值是一个空字符串或 null。

或 - regexinfos 中的一个或多个对象的正则表达式模式包含无效语法。

ArgumentNullException

assemblyname 或 regexinfos 为 null。

PlatformNotSupportedException

仅 .NET Core 和 .NET 5+ ：不支持创建已编译正则表达式的程序集。

示例

以下示例创建名为RegexLib.dll的程序集。该程序集包含两个编译的正则表达式。第一个， Utilities.RegularExpressions.DuplicatedString匹配两个相同的连续单词。第二个， Utilities.RegularExpressions.EmailAddress检查字符串是否具有正确的格式作为电子邮件地址。

using System;
using System.Collections.Generic;
using System.Reflection;
using System.Text.RegularExpressions;

public class RegexCompilationTest
{
   public static void Main()
   {
      RegexCompilationInfo expr;
      List<RegexCompilationInfo> compilationList = new List<RegexCompilationInfo>();

      // Define regular expression to detect duplicate words
      expr = new RegexCompilationInfo(@"\b(?<word>\w+)\s+(\k<word>)\b", 
                 RegexOptions.IgnoreCase | RegexOptions.CultureInvariant, 
                 "DuplicatedString", 
                 "Utilities.RegularExpressions", 
                 true);
      // Add info object to list of objects
      compilationList.Add(expr);

      // Define regular expression to validate format of email address
      expr = new RegexCompilationInfo(@"^(?("")(""[^""]+?""@)|(([0-9A-Z]((\.(?!\.))|[-!#\$%&'\*\+/=\?\^`\{\}\|~\w])*)(?<=[0-9A-Z])@))" + 
                 @"(?(\[)(\[(\d{1,3}\.){3}\d{1,3}\])|(([0-9A-Z][-\w]*[0-9A-Z]\.)+[A-Z]{2,6}))$", 
                 RegexOptions.IgnoreCase | RegexOptions.CultureInvariant, 
                 "EmailAddress", 
                 "Utilities.RegularExpressions", 
                 true);
      // Add info object to list of objects
      compilationList.Add(expr);
                                             
      // Generate assembly with compiled regular expressions
      RegexCompilationInfo[] compilationArray = new RegexCompilationInfo[compilationList.Count];
      AssemblyName assemName = new AssemblyName("RegexLib, Version=1.0.0.1001, Culture=neutral, PublicKeyToken=null");
      compilationList.CopyTo(compilationArray); 
      Regex.CompileToAssembly(compilationArray, assemName);                                                 
   }
}

Imports System.Collections.Generic
Imports System.Reflection
Imports System.Text.RegularExpressions

Module RegexCompilationTest
   Public Sub Main()
      Dim expr As RegexCompilationInfo
      Dim compilationList As New List(Of RegexCompilationInfo)
          
      ' Define regular expression to detect duplicate words
      expr = New RegexCompilationInfo("\b(?<word>\w+)\s+(\k<word>)\b", _
                 RegexOptions.IgnoreCase Or RegexOptions.CultureInvariant, _
                 "DuplicatedString", _
                 "Utilities.RegularExpressions", _
                 True)
      ' Add info object to list of objects
      compilationList.Add(expr)

      ' Define regular expression to validate format of email address
      expr = New RegexCompilationInfo("^(?("")(""[^""]+?""@)|(([0-9A-Z]((\.(?!\.))|[-!#\$%&'\*\+/=\?\^`\{\}\|~\w])*)(?<=[0-9A-Z])@))" + _
                 "(?(\[)(\[(\d{1,3}\.){3}\d{1,3}\])|(([0-9A-Z][-\w]*[0-9A-Z]\.)+[A-Z]{2,6}))$", _
                 RegexOptions.IgnoreCase Or RegexOptions.CultureInvariant, _
                 "EmailAddress", _
                 "Utilities.RegularExpressions", _
                 True)
      ' Add info object to list of objects
      compilationList.Add(expr)
                                             
      ' Generate assembly with compiled regular expressions
      Dim compilationArray(compilationList.Count - 1) As RegexCompilationInfo
      Dim assemName As New AssemblyName("RegexLib, Version=1.0.0.1001, Culture=neutral, PublicKeyToken=null")
      compilationList.CopyTo(compilationArray) 
      Regex.CompileToAssembly(compilationArray, assemName)                                                 
   End Sub
End Module

然后，以下示例实例化并使用检查字符串中重复单词的正则表达式。

using System;
using Utilities.RegularExpressions;

public class CompiledRegexUsage
{
   public static void Main()
   {
      string text = "The the quick brown fox  fox jumps over the lazy dog dog.";
      DuplicatedString duplicateRegex = new DuplicatedString(); 
      if (duplicateRegex.Matches(text).Count > 0)
         Console.WriteLine("There are {0} duplicate words in \n   '{1}'", 
            duplicateRegex.Matches(text).Count, text);
      else
         Console.WriteLine("There are no duplicate words in \n   '{0}'", 
                           text);
   }
}
// The example displays the following output to the console:
//    There are 3 duplicate words in
//       'The the quick brown fox  fox jumps over the lazy dog dog.'

Imports Utilities.RegularExpressions

Module CompiledRegexUsage
   Public Sub Main()
      Dim text As String = "The the quick brown fox  fox jumps over the lazy dog dog."
      Dim duplicateRegex As New DuplicatedString()
      If duplicateRegex.Matches(text).Count > 0 Then
         Console.WriteLine("There are {0} duplicate words in {2}   '{1}'", _
            duplicateRegex.Matches(text).Count, text, vbCrLf)
      Else
         Console.WriteLine("There are no duplicate words in {1}   '{0}'", _
                           text, vbCrLf)
      End If
   End Sub
End Module
' The example displays the following output to the console:
'    There are 3 duplicate words in
'       'The the quick brown fox  fox jumps over the lazy dog dog.'

成功编译此第二个示例需要引用RegexLib.dll (第一个示例创建的程序集) 添加到项目中。

注解

该方法CompileToAssembly(RegexCompilationInfo[], AssemblyName)生成一个.NET Framework程序集，其中数组中regexinfos定义的每个正则表达式都由类表示。通常，该方法 CompileToAssembly(RegexCompilationInfo[], AssemblyName) 是从生成已编译正则表达式程序集的单独应用程序中调用的。程序集中包含的每个正则表达式具有以下特征：

它派生自 Regex 类。
它分配由fullnamespace其相应RegexCompilationInfo对象的和name参数定义的完全限定名称。
它具有默认 (或无参数) 构造函数。

通常，实例化和使用已编译正则表达式的代码位于独立于创建程序集的代码的程序集或应用程序中。

调用方说明

如果要在安装了 .NET Framework 4.5 或其点版本的系统上进行开发，则以 .NET Framework 4 为目标，并使用CompileToAssembly(RegexCompilationInfo[], AssemblyName)该方法创建包含已编译正则表达式的程序集。尝试在该程序集中使用该程序集中的一个正则表达式，该程序集.NET Framework 4 将引发异常。若要解决此问题，可执行下列操作之一：

在安装了 .NET Framework 4 而不是更高版本的系统上生成包含已编译正则表达式的程序集。
在实例化Regex对象或调用正则表达式模式匹配方法时，不要从程序集调用CompileToAssembly(RegexCompilationInfo[], AssemblyName)和检索编译的正则表达式，而是将Compiled静态或实例Regex方法与选项一起使用。

另请参阅

编译和重复使用

适用于

CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[])

注意

Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.

将一个或多个指定的 Regex 对象编译为具有指定特性的命名程序集。

public:
 static void CompileToAssembly(cli::array <System::Text::RegularExpressions::RegexCompilationInfo ^> ^ regexinfos, System::Reflection::AssemblyName ^ assemblyname, cli::array <System::Reflection::Emit::CustomAttributeBuilder ^> ^ attributes);

public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname, System.Reflection.Emit.CustomAttributeBuilder[]? attributes);

[System.Obsolete("Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.", DiagnosticId="SYSLIB0036", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname, System.Reflection.Emit.CustomAttributeBuilder[]? attributes);

public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname, System.Reflection.Emit.CustomAttributeBuilder[] attributes);

static member CompileToAssembly : System.Text.RegularExpressions.RegexCompilationInfo[] * System.Reflection.AssemblyName * System.Reflection.Emit.CustomAttributeBuilder[] -> unit

[<System.Obsolete("Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.", DiagnosticId="SYSLIB0036", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member CompileToAssembly : System.Text.RegularExpressions.RegexCompilationInfo[] * System.Reflection.AssemblyName * System.Reflection.Emit.CustomAttributeBuilder[] -> unit

Public Shared Sub CompileToAssembly (regexinfos As RegexCompilationInfo(), assemblyname As AssemblyName, attributes As CustomAttributeBuilder())

参数

regexinfos: RegexCompilationInfo[]

描述要编译的正则表达式的数组。

assemblyname: AssemblyName

程序集的文件名。

attributes: CustomAttributeBuilder[]

定义要应用于程序集的特性的数组。

属性: ObsoleteAttribute

例外

ArgumentException

assemblyname 参数的 Name 属性值是一个空字符串或 null。

或 - regexinfos 中的一个或多个对象的正则表达式模式包含无效语法。

ArgumentNullException

assemblyname 或 regexinfos 为 null。

PlatformNotSupportedException

仅 .NET Core 和 .NET 5+ ：不支持创建已编译正则表达式的程序集。

示例

以下示例创建一个名为RegexLib.dll的程序集，并将该 AssemblyTitleAttribute 属性应用于该程序集。该程序集包含两个编译的正则表达式。第一个， Utilities.RegularExpressions.DuplicatedString匹配两个相同的连续单词。第二个， Utilities.RegularExpressions.EmailAddress检查字符串是否具有正确的格式作为电子邮件地址。

using System;
using System.Collections.Generic;
using System.Reflection;
using System.Reflection.Emit;
using System.Text.RegularExpressions;

public class RegexCompilationTest
{
   public static void Main()
   {
      RegexCompilationInfo expr;
      List<RegexCompilationInfo> compilationList = new List<RegexCompilationInfo>();

      // Define regular expression to detect duplicate words
      expr = new RegexCompilationInfo(@"\b(?<word>\w+)\s+(\k<word>)\b", 
                 RegexOptions.IgnoreCase | RegexOptions.CultureInvariant, 
                 "DuplicatedString", 
                 "Utilities.RegularExpressions", 
                 true);
      // Add info object to list of objects
      compilationList.Add(expr);

      // Define regular expression to validate format of email address
      expr = new RegexCompilationInfo(@"^(?("")(""[^""]+?""@)|(([0-9A-Z]((\.(?!\.))|[-!#\$%&'\*\+/=\?\^`\{\}\|~\w])*)(?<=[0-9A-Z])@))" + 
                 @"(?(\[)(\[(\d{1,3}\.){3}\d{1,3}\])|(([0-9A-Z][-\w]*[0-9A-Z]\.)+[zA-Z]{2,6}))$", 
                 RegexOptions.IgnoreCase | RegexOptions.CultureInvariant, 
                 "EmailAddress", 
                 "Utilities.RegularExpressions", 
                 true);
      // Add info object to list of objects
      compilationList.Add(expr);
                                             
      // Apply AssemblyTitle attribute to the new assembly
      //
      // Define the parameter(s) of the AssemblyTitle attribute's constructor 
      Type[] parameters = { typeof(string) };
      // Define the assembly's title
      object[] paramValues = { "General-purpose library of compiled regular expressions" };
      // Get the ConstructorInfo object representing the attribute's constructor
      ConstructorInfo ctor = typeof(System.Reflection.AssemblyTitleAttribute).GetConstructor(parameters);
      // Create the CustomAttributeBuilder object array
      CustomAttributeBuilder[] attBuilder = { new CustomAttributeBuilder(ctor, paramValues) }; 
                                                         
      // Generate assembly with compiled regular expressions
      RegexCompilationInfo[] compilationArray = new RegexCompilationInfo[compilationList.Count];
      AssemblyName assemName = new AssemblyName("RegexLib, Version=1.0.0.1001, Culture=neutral, PublicKeyToken=null");
      compilationList.CopyTo(compilationArray); 
      Regex.CompileToAssembly(compilationArray, assemName, attBuilder);                                                 
   }
}

Imports System.Collections.Generic
Imports System.Reflection
Imports System.Reflection.Emit
Imports System.Text.RegularExpressions

Module RegexCompilationTest
   Public Sub Main()
      Dim expr As RegexCompilationInfo
      Dim compilationList As New List(Of RegexCompilationInfo)
          
      ' Define regular expression to detect duplicate words
      expr = New RegexCompilationInfo("\b(?<word>\w+)\s+(\k<word>)\b", _
                 RegexOptions.IgnoreCase Or RegexOptions.CultureInvariant, _
                 "DuplicatedString", _
                 "Utilities.RegularExpressions", _
                 True)
      ' Add info object to list of objects
      compilationList.Add(expr)

      ' Define regular expression to validate format of email address
      expr = New RegexCompilationInfo("^(?("")(""[^""]+?""@)|(([0-9A-Z]((\.(?!\.))|[-!#\$%&'\*\+/=\?\^`\{\}\|~\w])*)(?<=[0-9A-Z])@))" + _ 
                 "(?(\[)(\[(\d{1,3}\.){3}\d{1,3}\])|(([0-9A-Z][-\w]*[0-9A-Z]\.)+[A-Z]{2,6}))$", _
                 RegexOptions.IgnoreCase Or RegexOptions.CultureInvariant, _
                 "EmailAddress", _
                 "Utilities.RegularExpressions", _
                 True)
      ' Add info object to list of objects
      compilationList.Add(expr)

      ' Apply AssemblyTitle attribute to the new assembly
      '
      ' Define the parameter(s) of the AssemblyTitle attribute's constructor 
      Dim params() As Type = { GetType(String) }
      ' Define the assembly's title
      Dim paramValues() As Object = { "General-purpose library of compiled regular expressions" }
      ' Get the ConstructorInfo object representing the attribute's constructor
      Dim ctor As ConstructorInfo = GetType(System.Reflection.AssemblyTitleAttribute).GetConstructor(params)
      ' Create the CustomAttributeBuilder object array
      Dim attBuilder() As CustomAttributeBuilder = { New CustomAttributeBuilder(ctor, paramValues) } 
                                                         
      ' Generate assembly with compiled regular expressions
      Dim compilationArray(compilationList.Count - 1) As RegexCompilationInfo
      Dim assemName As New AssemblyName("RegexLib, Version=1.0.0.1001, Culture=neutral, PublicKeyToken=null")
      compilationList.CopyTo(compilationArray) 
      Regex.CompileToAssembly(compilationArray, assemName, attBuilder) 
   End Sub
End Module

可以通过使用反射实用工具（如 ILDasm）检查其清单来验证 AssemblyTitleAttribute 属性是否已应用于程序集。

然后，以下示例实例化并使用检查字符串中重复单词的正则表达式。

using System;
using Utilities.RegularExpressions;

public class CompiledRegexUsage
{
   public static void Main()
   {
      string text = "The the quick brown fox  fox jumps over the lazy dog dog.";
      DuplicatedString duplicateRegex = new DuplicatedString(); 
      if (duplicateRegex.Matches(text).Count > 0)
         Console.WriteLine("There are {0} duplicate words in \n   '{1}'", 
            duplicateRegex.Matches(text).Count, text);
      else
         Console.WriteLine("There are no duplicate words in \n   '{0}'", 
                           text);
   }
}
// The example displays the following output to the console:
//    There are 3 duplicate words in
//       'The the quick brown fox  fox jumps over the lazy dog dog.'

Imports Utilities.RegularExpressions

Module CompiledRegexUsage
   Public Sub Main()
      Dim text As String = "The the quick brown fox  fox jumps over the lazy dog dog."
      Dim duplicateRegex As New DuplicatedString()
      If duplicateRegex.Matches(text).Count > 0 Then
         Console.WriteLine("There are {0} duplicate words in {2}   '{1}'", _
            duplicateRegex.Matches(text).Count, text, vbCrLf)
      Else
         Console.WriteLine("There are no duplicate words in {1}   '{0}'", _
                           text, vbCrLf)
      End If
   End Sub
End Module
' The example displays the following output to the console:
'    There are 3 duplicate words in
'       'The the quick brown fox  fox jumps over the lazy dog dog.'

成功编译此第二个示例需要引用RegexLib.dll (第一个示例创建的程序集) 添加到项目中。

注解

该方法CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[])生成一个.NET Framework程序集，其中数组中regexinfos定义的每个正则表达式都由类表示。通常，该方法 CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[]) 是从生成已编译正则表达式程序集的单独应用程序中调用的。程序集中包含的每个正则表达式具有以下特征：

它派生自 Regex 类。
它分配由fullnamespace其相应RegexCompilationInfo对象的和name参数定义的完全限定名称。
它具有默认 (或无参数) 构造函数。

通常，实例化和使用已编译正则表达式的代码位于独立于创建程序集的代码的程序集或应用程序中。

CompileToAssembly由于该方法从方法调用生成.NET Framework程序集，而不是使用特定语言的类定义关键字 (（例如class在 C# 或 Class...End Class Visual Basic) 中），因此不允许使用开发语言的标准属性语法将.NET Framework属性分配给程序集。该 attributes 参数提供了用于定义应用于程序集的属性的替代方法。对于要应用于程序集的每个属性，请执行以下操作：

创建表示要调用的属性构造函数的参数类型的对象的数组 Type 。
检索表示 Type 要应用于新程序集的属性类的对象。
GetConstructor调用属性Type对象的方法来检索ConstructorInfo表示要调用的属性构造函数的对象。传递 GetConstructor 表示构造函数参数类型的对象的数组 Type 。
创建一个 Object 数组，用于定义要传递给特性构造函数的参数。
通过传递ConstructorInfo在步骤 3 中检索到的对象和步骤 4 中创建的Object数组来实例CustomAttributeBuilder化对象。

然后，可以将这些 CustomAttributeBuilder 对象的数组而不是 attributes 参数传递给 Regex.CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[]) 方法。

调用方说明

在安装了 .NET Framework 4 而不是更高版本的系统上生成包含已编译正则表达式的程序集。
在实例化Regex对象或调用正则表达式模式匹配方法时，不要从程序集调用CompileToAssembly(RegexCompilationInfo[], AssemblyName)和检索编译的正则表达式，而是将Compiled静态或实例Regex方法与选项一起使用。

另请参阅

编译和重复使用

适用于

CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String)

注意

Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.

将一个或多个指定的 Regex 对象和一个指定的资源文件编译为具有指定特性的命名程序集。

public:
 static void CompileToAssembly(cli::array <System::Text::RegularExpressions::RegexCompilationInfo ^> ^ regexinfos, System::Reflection::AssemblyName ^ assemblyname, cli::array <System::Reflection::Emit::CustomAttributeBuilder ^> ^ attributes, System::String ^ resourceFile);

public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname, System.Reflection.Emit.CustomAttributeBuilder[]? attributes, string? resourceFile);

[System.Obsolete("Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.", DiagnosticId="SYSLIB0036", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname, System.Reflection.Emit.CustomAttributeBuilder[]? attributes, string? resourceFile);

public static void CompileToAssembly (System.Text.RegularExpressions.RegexCompilationInfo[] regexinfos, System.Reflection.AssemblyName assemblyname, System.Reflection.Emit.CustomAttributeBuilder[] attributes, string resourceFile);

static member CompileToAssembly : System.Text.RegularExpressions.RegexCompilationInfo[] * System.Reflection.AssemblyName * System.Reflection.Emit.CustomAttributeBuilder[] * string -> unit

[<System.Obsolete("Regex.CompileToAssembly is obsolete and not supported. Use the RegexGeneratorAttribute with the regular expression source generator instead.", DiagnosticId="SYSLIB0036", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member CompileToAssembly : System.Text.RegularExpressions.RegexCompilationInfo[] * System.Reflection.AssemblyName * System.Reflection.Emit.CustomAttributeBuilder[] * string -> unit

Public Shared Sub CompileToAssembly (regexinfos As RegexCompilationInfo(), assemblyname As AssemblyName, attributes As CustomAttributeBuilder(), resourceFile As String)

参数

regexinfos: RegexCompilationInfo[]

描述要编译的正则表达式的数组。

assemblyname: AssemblyName

程序集的文件名。

attributes: CustomAttributeBuilder[]

定义要应用于程序集的特性的数组。

resourceFile: String

要包含在程序集中的 Win32 资源文件的名称。

属性: ObsoleteAttribute

例外

ArgumentException

assemblyname 参数的 Name 属性值是一个空字符串或 null。

或 - regexinfos 中的一个或多个对象的正则表达式模式包含无效语法。

ArgumentNullException

assemblyname 或 regexinfos 为 null。

COMException

resourceFile 参数指定了无效的 Win32 资源文件。

FileNotFoundException

找不到 resourceFile 参数指定的文件。

PlatformNotSupportedException

仅 .NET Core 和 .NET 5+ ：不支持创建已编译正则表达式的程序集。

注解

该方法CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String)生成一个.NET Framework程序集，其中数组中regexinfos定义的每个正则表达式都由类表示。通常，该方法 CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String) 是从生成已编译正则表达式程序集的单独应用程序中调用的。程序集中包含的每个正则表达式具有以下特征：

它派生自 Regex 类。
它分配由fullnamespace其相应RegexCompilationInfo对象的和name参数定义的完全限定名称。
它具有默认 (或无参数) 构造函数。

通常，实例化和使用已编译正则表达式的代码位于独立于创建程序集的代码的程序集或应用程序中。

创建表示要调用的属性构造函数的参数类型的对象的数组 Type 。
检索表示 Type 要应用于新程序集的属性类的对象。
GetConstructor调用属性Type对象的方法来检索ConstructorInfo表示要调用的属性构造函数的对象。 GetConstructor传递表示构造函数参数类型的对象的数组Type的方法
创建一个 Object 数组，用于定义要传递给特性构造函数的参数。
通过传递ConstructorInfo在步骤 3 中检索到的对象和步骤 4 中创建的Object数组来实例CustomAttributeBuilder化对象。

然后，可以将这些 CustomAttributeBuilder 对象的数组而不是 attributes 参数传递给 CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String) 方法。

调用方说明

在安装了 .NET Framework 4 而不是更高版本的系统上生成包含已编译正则表达式的程序集。
在实例化Regex对象或调用正则表达式模式匹配方法时，不要从程序集调用CompileToAssembly(RegexCompilationInfo[], AssemblyName)和检索编译的正则表达式，而是将Compiled静态或实例Regex方法与选项一起使用。

另请参阅

编译和重复使用

适用于

Regex.CompileToAssembly 方法

定义

重载

注解

CompileToAssembly(RegexCompilationInfo[], AssemblyName)

参数

例外

示例

注解

调用方说明

另请参阅

适用于

CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[])

参数

例外

示例

注解

调用方说明

另请参阅

适用于

CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String)

参数

例外

注解

调用方说明

另请参阅

适用于

其他资源