ContainerCmdletProvider.ConvertPath(String, String, String, String) Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a new provider-specific path and filter (if any) that corresponds to the given path.
protected:
virtual bool ConvertPath(System::String ^ path, System::String ^ filter, System::String ^ % updatedPath, System::String ^ % updatedFilter);
virtual bool ConvertPath(std::wstring const & path, std::wstring const & filter, std::wstring const & & updatedPath, std::wstring const & & updatedFilter);
protected virtual bool ConvertPath (string path, string filter, ref string updatedPath, ref string updatedFilter);
abstract member ConvertPath : string * string * string * string -> bool
override this.ConvertPath : string * string * string * string -> bool
Protected Overridable Function ConvertPath (path As String, filter As String, ByRef updatedPath As String, ByRef updatedFilter As String) As Boolean
- path
- String
The path to the item. Unlike most other provider APIs, this path is likely to contain PowerShell wildcards.
- filter
- String
The provider-specific filter currently applied.
- updatedPath
- String
The new path to the item.
- updatedFilter
- String
The new filter.
True if the path or filter were altered. False otherwise.
Providers override this method if they support a native filtering syntax that can offer performance improvements over wildcard matching done by the PowerShell engine. If the provider can handle a portion (or all) of the PowerShell wildcard with semantics equivalent to the PowerShell wildcard, it may adjust the path to exclude the PowerShell wildcard. If the provider can augment the PowerShell wildcard with an approximate filter (but not replace it entirely,) it may simply return a filter without modifying the path. In this situation, PowerShell's wildcarding will still be applied to a smaller result set, resulting in improved performance.
The default implementation of this method leaves both Path and Filter unmodified.
PowerShell wildcarding semantics are handled by the System.Management.Automation.Wildcardpattern class.