PEReader.TryOpenAssociatedPortablePdb Method

Definition

Namespace:

System.Reflection.PortableExecutable

Assembly:

System.Reflection.Metadata.dll

Source:

PEReader.cs

Opens a Portable PDB associated with this PE image.

public:
 bool TryOpenAssociatedPortablePdb(System::String ^ peImagePath, Func<System::String ^, System::IO::Stream ^> ^ pdbFileStreamProvider, [Runtime::InteropServices::Out] System::Reflection::Metadata::MetadataReaderProvider ^ % pdbReaderProvider, [Runtime::InteropServices::Out] System::String ^ % pdbPath);

public bool TryOpenAssociatedPortablePdb (string peImagePath, Func<string,System.IO.Stream?> pdbFileStreamProvider, out System.Reflection.Metadata.MetadataReaderProvider? pdbReaderProvider, out string? pdbPath);

member this.TryOpenAssociatedPortablePdb : string * Func<string, System.IO.Stream> * MetadataReaderProvider * string -> bool

Public Function TryOpenAssociatedPortablePdb (peImagePath As String, pdbFileStreamProvider As Func(Of String, Stream), ByRef pdbReaderProvider As MetadataReaderProvider, ByRef pdbPath As String) As Boolean

Parameters

peImagePath

String

The path to the PE image. The path is used to locate the PDB file located in the directory containing the PE file.

pdbFileStreamProvider

Func<String,Stream>

If specified, called to open a Stream for a given file path. The provider is expected to either return a readable and seekable Stream, or null if the target file doesn't exist or should be ignored for some reason. The provider should throw IOException if it fails to open the file due to an unexpected IO error.

pdbReaderProvider

MetadataReaderProvider

If successful, a new instance of MetadataReaderProvider to be used to read the Portable PDB.

pdbPath

String

If successful and the PDB is found in a file, the path to the file, or null if the PDB is embedded in the PE image itself.

Returns

Boolean

true if the PE image has a PDB associated with it and the PDB has been successfully opened; otherwise, false.

Exceptions

ArgumentNullException

peImagePath or pdbFileStreamProvider is null.

InvalidOperationException

The stream returned from pdbFileStreamProvider doesn't support read and seek operations.

BadImageFormatException

No matching PDB file was found due to an error: The PE image or the PDB is invalid.

IOException

No matching PDB file was found due to an error: An IO error occurred while reading the PE image or the PDB.

Remarks

This method implements a simple PDB file lookup based on the content of the PE image Debug Directory. A more sophisticated tool might need to follow up with additional lookup on search paths or a symbol server.

The method looks the PDB up in the following order:

1. Checks for a matching PDB file of the name found in the CodeView entry in the directory containing the PE file (the directory of peImagePath).
2. Checks for a PDB embedded in the PE image itself.

The first PDB that matches the information specified in the Debug Directory is returned.