Add PDB support for PersistedAssemblyBuilder

[buyaa-n]

Added new APIs needed for adding symbol info and implemented PDB metadata generation

• Most PDB tables emitting is inspired by or copied from Roslyn implementation, especially sequence points section
• For unit testing used MetadataReader
  Approved API shape:

namespace System.Reflection.Emit;

public abstract partial class ModuleBuilder : System.Reflection.Module
{
    [EditorBrowsable(Never)]
    public ISymbolDocumentWriter DefineDocument (string url, Guid language, Guid languageVendor, Guid documentType) => DefineDocument(url, language);

    public ISymbolDocumentWriter DefineDocument(string url, Guid language = default);
    protected virtual ISymbolDocumentWriter DefineDocumentCore(string url, Guid language = default);
}

 public abstract partial class ILGenerator
 {
    public void MarkSequencePoint(ISymbolDocumentWriter document, int startLine, int startColumn, int endLine, int endColumn) { }
    protected virtual void MarkSequencePointCore(ISymbolDocumentWriter document, int startLine, int startColumn, int endLine, int endColumn) { }
 }
 
public abstract partial class LocalBuilder : LocalVariableInfo
{
    public void SetLocalSymInfo(string name);
    protected virtual void SetLocalSymInfoCore(string name) { }
}

public sealed class PersistedAssemblyBuilder : AssemblyBuilder
{
    public MetadataBuilder GenerateMetadata(out BlobBuilder ilStream, out BlobBuilder mappedFieldData, out MetadataBuilder pdbBuilder) { }
}

Contributes to #92975
Fixes #99935

[ghost]

Note regarding the new-api-needs-documentation label:

This serves as a reminder for when your PR is modifying a ref *.cs file and adding/modifying public APIs, please make sure the API implementation in the src *.cs file is documented with triple slash comments, so the PR reviewers can sign off that change.

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-system-reflection-emit
See info in area-owners.md if you want to be subscribed.

[buyaa-n]

I made it no-op in order to avoid breaking somebody that is not using/emitting PDB, but the more think about it is seems better to throw here so that people know that they are using an AssemblyBuilder implementation that doesn't support symbols.

[AaronRobinsonMSFT]

LGTM!

[steveharter]

Where did these max values come from?

[buyaa-n]

From the runtime doc

runtime/docs/design/specs/PortablePdb-Metadata.md

Lines 124 to 133 in 617f81f

	The values of non-hidden sequence point must satisfy the following constraints
	* IL Offset is within range [0, 0x20000000)
	* IL Offset of a sequence point is lesser than IL Offset of the subsequent sequence point.
	* Start Line is within range [0, 0x20000000) and not equal to 0xfeefee.
	* End Line is within range [0, 0x20000000) and not equal to 0xfeefee.
	* Start Column is within range [0, 0x10000)
	* End Column is within range [0, 0x10000)
	* End Line is greater or equal to Start Line.
	* If Start Line is equal to End Line then End Column is greater than Start Column.

[steveharter]

Where is LocalConstantHandle(1) coming from?

[buyaa-n]

runtime/src/libraries/System.Reflection.Metadata/src/System/Reflection/Metadata/Ecma335/MetadataBuilder.Tables.cs

Line 1266 in 64a937c

/// If no scope defines any constants, <see cref="MetadataTokens.LocalConstantHandle(int)"/>(1).