diff --git a/samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs b/samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs index bf84842b854..67dead9abac 100644 --- a/samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs +++ b/samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs @@ -13,8 +13,7 @@ class Program static string sourceFileName = "test.cs"; static void Main(string[] args) { - CodeDomProvider provider = - CodeDomProvider.CreateProvider(providerName); + CodeDomProvider provider = CodeDomProvider.CreateProvider(providerName); LogMessage("Building CodeDOM graph..."); @@ -22,11 +21,11 @@ static void Main(string[] args) cu = BuildHelloWorldGraph(); - // + // StreamWriter sourceFile = new StreamWriter(sourceFileName); provider.GenerateCodeFromCompileUnit(cu, sourceFile, null); sourceFile.Close(); - // + // // CompilerParameters opt = new CompilerParameters(new string[]{ @@ -59,8 +58,7 @@ static void Main(string[] args) } // - // Build a Hello World program graph using - // System.CodeDom types. + // Build a Hello World program graph using System.CodeDom types. public static CodeCompileUnit BuildHelloWorldGraph() { // Create a new CodeCompileUnit to contain @@ -82,9 +80,9 @@ public static CodeCompileUnit BuildHelloWorldGraph() class1.Comments.Add(new CodeCommentStatement("", true)); class1.Comments.Add(new CodeCommentStatement( "Create a Hello World application.", true)); + class1.Comments.Add(new CodeCommentStatement("", true)); class1.Comments.Add(new CodeCommentStatement( @"", true)); - class1.Comments.Add(new CodeCommentStatement("", true)); // Add the new type to the namespace type collection. samples.Types.Add(class1); diff --git a/samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb b/samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb index 01c54184472..3cfffed746d 100644 --- a/samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb +++ b/samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb @@ -4,8 +4,6 @@ Imports System.CodeDom.Compiler Imports System.IO Imports System.Text.RegularExpressions - - Class Program Private Shared providerName As String = "vb" Private Shared sourceFileName As String = "test.vb" @@ -21,7 +19,6 @@ Class Program cu = BuildHelloWorldGraph() ' - Dim sourceFile As New StreamWriter(sourceFileName) LogMessage("Generating code...") @@ -56,7 +53,6 @@ Class Program End Sub - ' ' Build a Hello World program graph using ' System.CodeDom types. @@ -80,10 +76,10 @@ Class Program class1.Comments.Add(New CodeCommentStatement("", True)) class1.Comments.Add(New CodeCommentStatement( _ "Create a Hello World application.", True)) + class1.Comments.Add(New CodeCommentStatement("", True)) class1.Comments.Add(New CodeCommentStatement( _ "", True)) - class1.Comments.Add(New CodeCommentStatement("", True)) ' Add the new type to the namespace type collection. samples.Types.Add(class1) @@ -139,7 +135,6 @@ Class Program End Sub - Shared Sub OutputResults(ByVal results As CompilerResults) LogMessage(("NativeCompilerReturnValue=" & _ results.NativeCompilerReturnValue.ToString())) @@ -150,4 +145,4 @@ Class Program End Sub End Class -' \ No newline at end of file +' diff --git a/xml/Microsoft.Extensions.DependencyInjection/OptionsBuilderDataAnnotationsExtensions.xml b/xml/Microsoft.Extensions.DependencyInjection/OptionsBuilderDataAnnotationsExtensions.xml index 3960df1c4c1..3ad3ebdc2fb 100644 --- a/xml/Microsoft.Extensions.DependencyInjection/OptionsBuilderDataAnnotationsExtensions.xml +++ b/xml/Microsoft.Extensions.DependencyInjection/OptionsBuilderDataAnnotationsExtensions.xml @@ -16,7 +16,7 @@ - Extension methods for adding configuration related options services to the DI container via . + Extension methods for adding configuration-related options services to the DI container via . To be added. @@ -50,7 +50,7 @@ The options type to be configured. The options builder to add the services to. - Register this options instance for validation of its DataAnnotations. + Registers this options instance for validation of its DataAnnotations. The so that additional calls can be chained. To be added. diff --git a/xml/Microsoft.Extensions.DependencyInjection/OptionsServiceCollectionExtensions.xml b/xml/Microsoft.Extensions.DependencyInjection/OptionsServiceCollectionExtensions.xml index 18f9e8ab3cd..661ad02c58e 100644 --- a/xml/Microsoft.Extensions.DependencyInjection/OptionsServiceCollectionExtensions.xml +++ b/xml/Microsoft.Extensions.DependencyInjection/OptionsServiceCollectionExtensions.xml @@ -86,7 +86,7 @@ The options type to be configured. The to add the services to. - Gets an options builder that forwards Configure calls for the same to the underlying service collection. + Gets an options builder that forwards Configure calls for the same named to the underlying service collection. The so that configure calls can be chained in it. To be added. @@ -124,8 +124,8 @@ The options type to be configured. The to add the services to. The name of the options instance. - Gets an options builder that forwards Configure calls for the same named to the underlying service collection. - The so that configure calls can be chained in it. + Gets an options builder that forwards Configure calls for the same named to the underlying service collection. + The so that Configure calls can be chained in it. To be added. @@ -165,8 +165,7 @@ The options type to be configured. The to add the services to. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before . The so that additional calls can be chained. To be added. @@ -207,8 +206,7 @@ The to add the services to. The name of the options instance. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before . The so that additional calls can be chained. To be added. @@ -277,7 +275,7 @@ The to add the services to. The instance that will configure options. - Registers an object that will have all of its I[Post]ConfigureOptions registered. + Registers an object that will have all of its I[Post]ConfigureOptions registered. The so that additional calls can be chained. To be added. @@ -307,7 +305,7 @@ The to add the services to. The type that will configure options. - Registers a type that will have all of its I[Post]ConfigureOptions registered. + Registers a type that will have all of its I[Post]ConfigureOptions registered. The so that additional calls can be chained. To be added. @@ -343,7 +341,7 @@ The type that will configure options. The to add the services to. - Registers a type that will have all of its I[Post]ConfigureOptions registered. + Registers a type that will have all of its I[Post]ConfigureOptions registered. The so that additional calls can be chained. To be added. @@ -382,8 +380,7 @@ The options type to be configured. The to add the services to. The action used to configure the options. - Registers an action used to initialize a particular type of options. - Note: These are run after all . + Registers an action used to initialize a particular type of options. These are run after . The so that additional calls can be chained. To be added. @@ -424,8 +421,7 @@ The to add the services to. The name of the options instance. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run after all . + Registers an action used to configure a particular type of options. These are run after . The so that additional calls can be chained. To be added. @@ -464,8 +460,7 @@ The options type to be configured. The to add the services to. The action used to configure the options. - Registers an action used to post configure all instances of a particular type of options. - Note: These are run after all . + Registers an action used to post configure all instances of a particular type of options. These are run after . The so that additional calls can be chained. To be added. diff --git a/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalFilesWatcher.xml b/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalFilesWatcher.xml index f664ab0f1d0..16409b2d883 100644 --- a/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalFilesWatcher.xml +++ b/xml/Microsoft.Extensions.FileProviders.Physical/PhysicalFilesWatcher.xml @@ -55,13 +55,10 @@ - Root directory for the watcher - The wrapped watcher that is watching - - True when the watcher should use polling to trigger instances of - created by - Initializes an instance of that watches files in . - Wraps an instance of + Root directory for the watcher. + The wrapped watcher that is watching . + when the watcher should use polling to trigger instances of created by . + Initializes an instance of that watches files in . Wraps an instance of . To be added. @@ -87,14 +84,12 @@ - Root directory for the watcher - The wrapped watcher that is watching - - True when the watcher should use polling to trigger instances of - created by + Root directory for the watcher. + The wrapped watcher that is watching . + when the watcher should use polling to trigger instances of + created by . Specifies which files or directories are excluded. Notifications of changes to are not raised to these. - Initializes an instance of that watches files in . - Wraps an instance of + Initializes an instance of that watches files in . Wraps an instance of . To be added. @@ -123,17 +118,14 @@ - A globbing pattern for files and directories to watch + A globbing pattern for files and directories to watch. - Creates an instance of for all files and directories that match the - - Globbing patterns are relative to the root directory given in the constructor - . Globbing patterns - are interpreted by . + Creates an instance of for all files and directories that match the . + Globbing patterns are relative to the root directory given in the constructor . Globbing patterns are interpreted by . - A change token for all files that match the filter + A change token for all files that match the filter. To be added. - When is null + When is null. @@ -187,8 +179,7 @@ - - is invoked from . + If , is invoked from . Disposes the provider. To be added. diff --git a/xml/Microsoft.Extensions.FileProviders/PhysicalFileProvider.xml b/xml/Microsoft.Extensions.FileProviders/PhysicalFileProvider.xml index 228b0722b8c..e8bda4cff60 100644 --- a/xml/Microsoft.Extensions.FileProviders/PhysicalFileProvider.xml +++ b/xml/Microsoft.Extensions.FileProviders/PhysicalFileProvider.xml @@ -285,14 +285,13 @@ Gets or sets a value that determines if this instance of actively polls for file changes. - When , returned by will actively poll for file changes - ( will be ) instead of being passive. + When , the returned by actively polls for file changes + ( is ) instead of being passive. This property is only effective when is set. - - The default value of this property is determined by the value of environment variable named DOTNET_USE_POLLING_FILE_WATCHER. - When or 1, this property defaults to ; otherwise false. + The default value of this property is determined by the value of the environment variable named DOTNET_USE_POLLING_FILE_WATCHER. + When or 1, this property defaults to ; otherwise . To be added. @@ -318,15 +317,14 @@ Gets or sets a value that determines if this instance of uses polling to determine file changes. - By default, uses to listen to file change events - for . is ineffective in some scenarios such as mounted drives. - Polling is required to effectively watch for file changes. - . + By default, uses to listen to file change events for . is ineffective in some scenarios such as mounted drives. Polling is required to effectively watch for file changes. + + - The default value of this property is determined by the value of environment variable named DOTNET_USE_POLLING_FILE_WATCHER. - When or 1, this property defaults to ; otherwise false. + The default value of this property is determined by the value of environment variable named DOTNET_USE_POLLING_FILE_WATCHER. When or 1, this property defaults to ; otherwise . To be added. + @@ -358,19 +356,14 @@ - Filter string used to determine what files or folders to monitor. Example: **/*.cs, *.*, - subFolder/**/*.cshtml. + Filter string used to determine what files or folders to monitor. Examples: \*\*/\*.cs, \*.\*, subfolder/\*\*/\*.cshtml. - Creates a for the specified . - Globbing patterns are interpreted by . + Creates an for the specified . + Globbing patterns are interpreted by . - An that is notified when a file matching is added, - modified or deleted. Returns a if has invalid filter - characters or if is an absolute path or outside the root directory specified in the - constructor . - . + An that's notified when a file matching is added, modified, or deleted.ORA if has invalid filter characters or is an absolute path or is outside the root directory specified in the constructor . To be added. diff --git a/xml/Microsoft.Extensions.FileSystemGlobbing.Abstractions/DirectoryInfoWrapper.xml b/xml/Microsoft.Extensions.FileSystemGlobbing.Abstractions/DirectoryInfoWrapper.xml index cdfa47a6b46..dcdc8c4b5f6 100644 --- a/xml/Microsoft.Extensions.FileSystemGlobbing.Abstractions/DirectoryInfoWrapper.xml +++ b/xml/Microsoft.Extensions.FileSystemGlobbing.Abstractions/DirectoryInfoWrapper.xml @@ -138,7 +138,7 @@ Returns the full path to the directory. To be added. - Equals the value of . + Equals the value of . @@ -256,7 +256,7 @@ Returns the parent directory. To be added. - Equals the value of . + Equals the value of . diff --git a/xml/Microsoft.Extensions.FileSystemGlobbing/Matcher.xml b/xml/Microsoft.Extensions.FileSystemGlobbing/Matcher.xml index f09c0eb972c..29e35329774 100644 --- a/xml/Microsoft.Extensions.FileSystemGlobbing/Matcher.xml +++ b/xml/Microsoft.Extensions.FileSystemGlobbing/Matcher.xml @@ -22,71 +22,98 @@ Searches the file system for files with names that match specified patterns. - Patterns specified in and can use - the following formats to match multiple files or directories. + Patterns specified in and can use the following formats to match multiple files or directories. - - exact directory and file name - - + Exact directory and file name. - "one.txt" + one.txt - "dir/two.txt" + dir/two.txt - - wildcards (*) in file and directory names that represent zero to many characters not including - directory separators characters - - - + Wildcards (*) in file and directory names that represent zero to many characters not including directory separators characters. + + + Value + Description + + + *.txt + All files with .txt file extension. + + + *.* + All files with an extension. + + + * + All files in top-level directory. + + + .* + File names beginning with '.'. + - "*.txt" - all files with .txt file extension + *word* + All files with 'word' in the filename. - "*.*" - all files with an extension + readme.* + All files named 'readme' with any file extension. - "*" - all files in top level directory + styles/*.css + All files with extension '.css' in the directory 'styles/'. - ".*" - filenames beginning with '.' + scripts/*/* + All files in 'scripts/' or one level of subdirectory under 'scripts/'. - - "*word* - all files with 'word' in the filename - "readme.*"all files named 'readme' with any file extension"styles/*.css"all files with extension '.css' in the directory 'styles/'"scripts/*/*"all files in 'scripts/' or one level of subdirectory under 'scripts/'"images*/*"all files in a folder with name that is or begins with 'images' + + images*/* + All files in a folder with name that is or begins with 'images'. + + - arbitrary directory depth ("/**/") - - + Arbitrary directory depth (/**/). + + + Value + Description + - "**/*" - all files in any subdirectory + **/* + All files in any subdirectory. - "dir/**/*" - all files in any subdirectory under 'dir/' + dir/**/* + All files in any subdirectory under 'dir/'. - relative paths - - '../shared/*' - all files in a diretory named 'shared' at the sibling level to the base directory given - to + Relative paths. + + + Value + Description + + + ../shared/* + All files in a diretory named "shared" at the sibling level to the base directory given to . + + + + diff --git a/xml/Microsoft.Extensions.FileSystemGlobbing/MatcherExtensions.xml b/xml/Microsoft.Extensions.FileSystemGlobbing/MatcherExtensions.xml index a2335327181..b5739ea57bd 100644 --- a/xml/Microsoft.Extensions.FileSystemGlobbing/MatcherExtensions.xml +++ b/xml/Microsoft.Extensions.FileSystemGlobbing/MatcherExtensions.xml @@ -56,10 +56,11 @@ - The matcher to which the exclude patterns are added - A list of globbing patterns - Adds multiple exclude patterns to . + The matcher to which the exclude patterns are added. + A list of globbing patterns. + Adds multiple exclude patterns to . To be added. + @@ -94,10 +95,11 @@ - The matcher to which the include patterns are added - A list of globbing patterns - Adds multiple patterns to include in . See + The matcher to which the include patterns are added. + A list of globbing patterns. + Adds multiple patterns to include in . To be added. + @@ -126,9 +128,9 @@ - The matcher - The root directory for the search - Searches the directory specified for all files matching patterns added to this instance of + The matcher. + The root directory for the search. + Searches the specified directory for all files matching patterns added to this instance of . Absolute file paths of all files matched. Empty enumerable if no files matched given patterns. To be added. diff --git a/xml/Microsoft.Extensions.Options/OptionsBuilder`1.xml b/xml/Microsoft.Extensions.Options/OptionsBuilder`1.xml index 7b1a285466c..aaa81bf66d4 100644 --- a/xml/Microsoft.Extensions.Options/OptionsBuilder`1.xml +++ b/xml/Microsoft.Extensions.Options/OptionsBuilder`1.xml @@ -78,8 +78,7 @@ The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before all . The current . To be added. @@ -115,8 +114,7 @@ A dependency used by the action. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before all . The current . To be added. @@ -158,8 +156,7 @@ The first dependency used by the action. The second dependency used by the action. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before all . The current . To be added. @@ -207,8 +204,7 @@ The second dependency used by the action. The third dependency used by the action. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before all . The current . To be added. @@ -262,8 +258,7 @@ The third dependency used by the action. The fourth dependency used by the action. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before all . The current . To be added. @@ -323,8 +318,7 @@ The fourth dependency used by the action. The fifth dependency used by the action. The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run before all . + Registers an action used to configure a particular type of options. These are run before all . The current . To be added. @@ -376,8 +370,7 @@ The action used to configure the options. - Registers an action used to configure a particular type of options. - Note: These are run after all . + Registers an action used to configure a particular type of options. These are run after all . To be added. To be added. @@ -413,8 +406,7 @@ The dependency used by the action. The action used to configure the options. - Registers an action used to post configure a particular type of options. - Note: These are run after all . + Registers an action used to post configure a particular type of options. These are run after all . The current . To be added. @@ -456,8 +448,7 @@ The first dependency used by the action. The second dependency used by the action. The action used to configure the options. - Registers an action used to post configure a particular type of options. - Note: These are run after all . + Registers an action used to post configure a particular type of options. These are run after all . The current . To be added. @@ -505,8 +496,7 @@ The second dependency used by the action. The third dependency used by the action. The action used to configure the options. - Registers an action used to post configure a particular type of options. - Note: These are run after all . + Registers an action used to post configure a particular type of options. These are run after all . The current . To be added. @@ -560,8 +550,7 @@ The third dependency used by the action. The fourth dependency used by the action. The action used to configure the options. - Registers an action used to post configure a particular type of options. - Note: These are run after all . + Registers an action used to post configure a particular type of options. These are run after all . The current . To be added. @@ -621,8 +610,7 @@ The fourth dependency used by the action. The fifth dependency used by the action. The action used to configure the options. - Registers an action used to post configure a particular type of options. - Note: These are run after all . + Registers an action used to post configure a particular type of options. These are run after all . The current . To be added. diff --git a/xml/Microsoft.VisualBasic.CompilerServices/ObjectType.xml b/xml/Microsoft.VisualBasic.CompilerServices/ObjectType.xml index 6c01b2ed08e..62fc3cf8d51 100644 --- a/xml/Microsoft.VisualBasic.CompilerServices/ObjectType.xml +++ b/xml/Microsoft.VisualBasic.CompilerServices/ObjectType.xml @@ -687,7 +687,7 @@ - . + - . + - . + - . + Required. . Any valid file number. Returns an enumeration representing the file mode for files opened using the function. The gives you better productivity and performance in file I/O operations than the function. See for more information. - The following enumeration values indicate the file access mode: - - Value - - Mode - - 1 - - 2 - - 4 - - 8 - - 32 - - + One of the following values: + + + + Value + File access mode + + 1 + 2 + 4 + 8 + 32 + + Optional. Numeric expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. If you omit , the default value is zero. Optional. expression displayed in the title bar of the dialog box. If you omit , the application name is placed in the title bar. Displays a message in a dialog box, waits for the user to click a button, and then returns an integer indicating which button the user clicked. - + One of the following values: + + Constant + Value + - Constant - - - Value - - + + 1 - - - - 1 - - + + 2 - - - - 2 - - + + 3 - - - - 3 - - + + 4 - - - - 4 - - + + 5 - - - - 5 - - + + 6 - - - - 6 - - - - - - - - 7 - - + + 7 - . + event for the form. > [!NOTE] -> The `MsgBox` function requires `UIPermission` at the level, which may affect its execution in partial-trust situations. For more information, see . +> The `MsgBox` function requires `UIPermission` at the level, which may affect its execution in partial-trust situations. For more information, see . The `MsgBoxStyle` enumeration values are listed in the following table. @@ -1241,9 +1209,7 @@ drawObj.SaveAs("C:\Drawings\sample.drw") |`MsgBoxRight`|524288|Text is right-aligned.| |`MsgBoxRtlReading`|1048576|Specifies text should appear as right-to-left reading on Hebrew and Arabic systems.| - The first group of values (0-5) describes the number and type of buttons displayed in the dialog box. The second group (16, 32, 48, 64) describes the icon style. The third group (0, 256, 512) determines which button is the default. The fourth group (0, 4096) determines the modality of the message box, and the fifth group specifies whether or not the message box window is the foreground window, along with the alignment and direction of the text. When adding numbers to create a final value for the `Buttons` argument, use only one number from each group. - - + The first group of values (0-5) describes the number and type of buttons displayed in the dialog box. The second group (16, 32, 48, 64) describes the icon style. The third group (0, 256, 512) determines which button is the default. The fourth group (0, 4096) determines the modality of the message box, and the fifth group specifies whether or not the message box window is the foreground window, along with the alignment and direction of the text. When adding numbers to create a final value for the `Buttons` argument, use only one number from each group. ## Examples This example uses the `MsgBox` function to display a critical-error message in a dialog box with Yes and No buttons. The No button is specified as the default response. This is done by combining the `MsgBox` constant values into one numeric expression. In this case, adding 4 (the Yes/No button combination) and 16 (the **Critical Message** window) and 256 (the second button as default button) gives a total of 276. The value returned by the `MsgBox` function depends on the button chosen by the user: Yes returns a value of 6; No returns a value of 7. @@ -1315,9 +1281,7 @@ drawObj.SaveAs("C:\Drawings\sample.drw") If `Interval` is 1, the range is "`Number`:`Number`", regardless of the `Start` and `Stop` arguments. For example, if `Number` is 267, `Stop` is 1000, and `Interval` is 1, `Partition` returns " 267: 267". - `Partition` can be useful when constructing database queries. You can create a SELECT query that shows how many orders occur within various value ranges, for example with invoice values from 1 to 1000, 1001 to 2000, and so on. - - + `Partition` can be useful when constructing database queries. You can create a SELECT query that shows how many orders occur within various value ranges, for example with invoice values from 1 to 1000, 1001 to 2000, and so on. ## Examples The following example sets up a series of ranges for decades from 1950 through 2049. It locates the value of `year` within the appropriate range and returns a `String` value showing the range. If `year` has a value of 1984, for example, `Partition` returns "1980:1989". @@ -1376,9 +1340,7 @@ drawObj.SaveAs("C:\Drawings\sample.drw") Registry settings that are to be accessed from a non-interactive process (such as Mtx.exe) should be stored under either the `HKEY_LOCAL_MACHINE\Software\` or the `HKEY_USER\DEFAULT\Software` registry keys. - `SaveSetting` requires `Write` and `Create` . - - + `SaveSetting` requires `Write` and `Create` . ## Examples The following example first uses the `SaveSetting` function to make entries in the Windows registry for the `MyApp` application, and then uses the `DeleteSetting` function to remove them. @@ -1492,9 +1454,7 @@ ID = Shell("""C:\Program Files\display.exe"" -a -q", , True, 100000) > If you do not enclose the path and file specification in quotation marks, there is a security risk if the file name or a path node contains spaces. In the preceding example, the path node `\Program Files` includes a space. If the specification were not inside quotation marks and a program named `Program.exe` had been installed in C:\\, for example by illicit tampering, Windows would execute it instead of `display.exe`. > [!IMPORTANT] -> The `Shell` function requires unmanaged code permission, which might affect its execution in partial-trust situations. For more information, see and [Code Access Permissions](https://msdn.microsoft.com/library/e5ae402f-6dda-4732-bbe8-77296630f675). - - +> The `Shell` function requires unmanaged code permission, which might affect its execution in partial-trust situations. For more information, see and [Code Access Permissions](https://msdn.microsoft.com/library/e5ae402f-6dda-4732-bbe8-77296630f675). ## Examples The following example uses the `Shell` function to run an application specified by the user. Specifying as the second argument opens the application in normal size and gives it the focus. @@ -1561,9 +1521,7 @@ ID = Shell("""C:\Program Files\display.exe"" -a -q", , True, 100000) If you do not supply the `VarExpr` argument, `Switch` returns `Nothing`. > [!NOTE] -> The expressions in the argument list can include function calls. As part of preparing the argument list for the call to `Switch`, the Visual Basic compiler calls every function in every expression. This means that you cannot rely on a particular function not being called if an expression earlier in the argument list is `True`. - - +> The expressions in the argument list can include function calls. As part of preparing the argument list for the call to `Switch`, the Visual Basic compiler calls every function in every expression. This means that you cannot rely on a particular function not being called if an expression earlier in the argument list is `True`. ## Examples The following example uses the `Switch` function to return the name of a language that matches the name of a city. It requires that `Option Strict` be `Off`. diff --git a/xml/Microsoft.VisualBasic/Strings.xml b/xml/Microsoft.VisualBasic/Strings.xml index 57883fc6754..6636b119ccc 100644 --- a/xml/Microsoft.VisualBasic/Strings.xml +++ b/xml/Microsoft.VisualBasic/Strings.xml @@ -1210,52 +1210,28 @@ Returns an integer specifying the start position of the first occurrence of one string within another. + + If + InStr returns + - If - - - InStr returns - - - - - - is zero length or - 0 - - + is zero length or + 0 - - is zero length or - The starting position for the search, which defaults to the first character position. - - - - - - is not found - - - 0 - - + is zero length or + The starting position for the search, which defaults to the first character position. - - is found within - Position where match begins - - + is not found + 0 - - - - + is found within + Position where match begins. - . + [!NOTE] -> The `InStrB` function in previous versions of Visual Basic returns a number of bytes rather than a character position. It is used primarily for converting strings in double-byte character set (DBCS) applications. All Visual Basic 2005 strings are in Unicode, and `InStrB` is no longer supported. +> The `InStrB` function in previous versions of Visual Basic returns a number of bytes rather than a character position. It is used primarily for converting strings in double-byte character set (DBCS) applications. All Visual Basic 2005 strings are in Unicode, and `InStrB` is no longer supported. The `Compare` argument settings are: |Constant|Value|Description| |-|-|-| |`Binary`|0|Performs a binary comparison| -|`Text`|1|Performs a text comparison| - - +|`Text`|1|Performs a text comparison| ## Examples This example uses the `InStr` function to return the position of the first occurrence of one string within another. @@ -1338,53 +1312,32 @@ Returns an integer specifying the start position of the first occurrence of one string within another. + + If + InStr returns + - If - - - InStr returns - - + is zero length or + 0 - - is zero length or - 0 - - + is zero length or + - - is zero length or - - - + is not found + 0 - - is not found - - - 0 - - + is found within + Position where match begins - - is found within - Position where match begins - - - - - - > length of - 0 - - + > length of + 0 - . + Returns the position of the first occurrence of one string within another, starting from the right side of the string. + + If + InStrRev returns + - If - - - InStrRev returns - - + is zero-length + 0 - - is zero-length - - - 0 - - - - - - is zero-length - - - - - + is zero-length + - - is not found - - - 0 - - + is not found + 0 - - is found within - Position at which the first match is found, starting with the right side of the string. - - + is found within + Position at which the first match is found, starting with the right side of the string. - - is greater than length of - 0 - - + is greater than length of + 0 - . + Optional. Number of substring substitutions to perform. If omitted, the default value is -1, which means "make all possible substitutions." Optional. Numeric value indicating the kind of comparison to use when evaluating substrings. See Settings for values. Returns a string in which a specified substring has been replaced with another substring a specified number of times. - - returns the following values. - - If - - Replace returns - - is zero-length or Copy of is zero-length - - Copy of with no occurrences of is zero-length or , or is greater than length of is 0 - - Copy of + One of the following values. + + + If + Replace returns + + + is zero-length or + Copy of + + + is zero-length + Copy of with no occurrences of + + + is zero-length or , or is greater than length of + + + + is 0 + Copy of + + + Required. Any valid expression. Optional. Specifies the type of string comparison. If is omitted, the setting determines the type of comparison. Returns -1, 0, or 1, based on the result of a string comparison. - The function has the following return values. - - If - - StrComp returns - - sorts ahead of -1 - - is equal to 0 - - sorts after 1 - - + One of the following values: + + + If + StrComp returns + + + sorts ahead of + -1 + + + is equal to + 0 + + + sorts after + 1 + + + If has not been specified, the value of is returned. If has been specified and represents a resource key within that resource type, the localized value is returned. If and have not been set, returns . - . + To be added. Both the and properties are set, but a public static property with a name matching the value cannot be found on the . diff --git a/xml/System.Data.OracleClient/OracleBinary.xml b/xml/System.Data.OracleClient/OracleBinary.xml index 86e49598e6c..b26a28d5f39 100644 --- a/xml/System.Data.OracleClient/OracleBinary.xml +++ b/xml/System.Data.OracleClient/OracleBinary.xml @@ -99,11 +99,7 @@ Greater than zero - This object is greater than the object. - - -or- - - The object is a null reference. + This object is greater than the object, or the object is a null reference. To be added. diff --git a/xml/System.Data.OracleClient/OracleBoolean.xml b/xml/System.Data.OracleClient/OracleBoolean.xml index 2ba4557fb0f..8a55846e5e1 100644 --- a/xml/System.Data.OracleClient/OracleBoolean.xml +++ b/xml/System.Data.OracleClient/OracleBoolean.xml @@ -170,11 +170,7 @@ A positive integer - This instance is greater than . - - -or- - - is a null reference ( in Visual Basic). + This instance is greater than , or is a null reference ( in Visual Basic). diff --git a/xml/System.Data.Services.Providers/DataServiceProviderMethods.xml b/xml/System.Data.Services.Providers/DataServiceProviderMethods.xml index 5f647b64f21..23507776aa0 100644 --- a/xml/System.Data.Services.Providers/DataServiceProviderMethods.xml +++ b/xml/System.Data.Services.Providers/DataServiceProviderMethods.xml @@ -80,7 +80,7 @@ - . + - . + - . + - . + - . + Greater than zero - This object is greater than object. - - -or- - - The object is a null reference. + This object is greater than object, or the object is a null reference. To be added. @@ -307,11 +303,7 @@ Greater than zero - This object is greater than object. - - -or- - - The object is a null reference. + This object is greater than object, or the object is a null reference. To be added. diff --git a/xml/System.Data.SqlTypes/SqlBoolean.xml b/xml/System.Data.SqlTypes/SqlBoolean.xml index 1d92d6cc386..ff57017f5b7 100644 --- a/xml/System.Data.SqlTypes/SqlBoolean.xml +++ b/xml/System.Data.SqlTypes/SqlBoolean.xml @@ -339,11 +339,7 @@ A positive integer - This instance is greater than . - - -or- - - is a null reference ( in Visual Basic). + This instance is greater than , or is a null reference ( in Visual Basic). @@ -416,11 +412,7 @@ A positive integer - This instance is greater than . - - -or- - - is a null reference ( in Visual Basic). + This instance is greater than , or is a null reference ( in Visual Basic). diff --git a/xml/System.Data.SqlTypes/SqlInt16.xml b/xml/System.Data.SqlTypes/SqlInt16.xml index e22dee08916..5707fe60e4e 100644 --- a/xml/System.Data.SqlTypes/SqlInt16.xml +++ b/xml/System.Data.SqlTypes/SqlInt16.xml @@ -317,11 +317,7 @@ Greater than zero - This instance is greater than the object - - -or- - - The object is a null reference ( in Visual Basic) + This instance is greater than the object, or the object is a null reference ( in Visual Basic) To be added. diff --git a/xml/System.DirectoryServices.AccountManagement/PrincipalValueCollection`1.xml b/xml/System.DirectoryServices.AccountManagement/PrincipalValueCollection`1.xml index 45c208e370c..13a0a7dc47d 100644 --- a/xml/System.DirectoryServices.AccountManagement/PrincipalValueCollection`1.xml +++ b/xml/System.DirectoryServices.AccountManagement/PrincipalValueCollection`1.xml @@ -749,7 +749,7 @@ Returns a bool indicating whether the specified object is in the collection. - . + To be added. diff --git a/xml/System.IO/DirectoryInfo.xml b/xml/System.IO/DirectoryInfo.xml index 655185b60b3..2f5df188403 100644 --- a/xml/System.IO/DirectoryInfo.xml +++ b/xml/System.IO/DirectoryInfo.xml @@ -226,9 +226,7 @@ If the directory did not exist before calling this method, then any cached attribute information about the directory will be flushed if the creation is successful. - For a list of common I/O tasks, see [Common I/O Tasks](/dotnet/standard/io/common-i-o-tasks). - - + For a list of common I/O tasks, see [Common I/O Tasks](/dotnet/standard/io/common-i-o-tasks). ## Examples The following example checks whether a specified directory exists, creates the directory if it does not exist, and deletes the directory. @@ -1904,13 +1902,11 @@ namespace ConsoleApp method overload and specifying the access control sections | | (`Or``Or` in Visual Basic). + Calling this method overload is equivalent to calling the method overload and specifying the access control sections | | ( `Or` `Or` in Visual Basic). Use the method to retrieve the access control list (ACL) entries for the current file. - An ACL describes individuals and/or groups who have, or do not have, rights to specific actions on the given file or directory. For more information, see [How to: Add or Remove Access Control List Entries](/dotnet/standard/io/how-to-add-or-remove-access-control-list-entries). - - + An ACL describes individuals and/or groups who have, or do not have, rights to specific actions on the given file or directory. For more information, see [How to: Add or Remove Access Control List Entries](/dotnet/standard/io/how-to-add-or-remove-access-control-list-entries). ## Examples The following example uses the and methods to add and then remove an access control list (ACL) entry from a directory. @@ -1963,31 +1959,11 @@ namespace ConsoleApp One of the values that specifies the type of access control list (ACL) information to receive. Gets a object that encapsulates the specified type of access control list (ACL) entries for the directory described by the current object. - A object that encapsulates the access control rules for the file described by the parameter. - - Exceptions - - Exception type - - Condition - - The directory could not be found or modified. - - The current process does not have access to open the directory. - - An I/O error occurred while opening the directory. - - The directory is read-only. - - -or- - - This operation is not supported on the current platform. - - -or- - - The caller does not have the required permission. - - + A object that encapsulates the access control rules for the file described by the parameter. + The directory could not be found or modified. + The current process does not have access to open the directory.
OR
The directory is read-only.
OR
This operation is not supported on the current platform.
OR
The caller does not have the required permission. + + An I/O error occurred while opening the directory. of any of the paths in `paths` is zero, the method concatenates the remaining arguments. If the resulting concatenated string's length is zero, the method returns . -If any of the paths in `paths`, except for the last one, ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: +If any of the paths in `paths`, except for the last one, ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: - Retrieve the value of the property rather than hard-coding a directory separator character. @@ -2470,7 +2470,7 @@ Not all invalid characters for directory and file names are interpreted as unacc This method simply concatenates `path` and `path2` and adds a directory separator character between the two path components if one is not already present at the end of `path1` or the beginning of `path2`. If the of either `path1` or `path2` is zero, the method returns the other path. If the of both `path1` and `path2` is zero, the method returns . -If `path1` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: +If `path1` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: - Retrieve the value of the property rather than hard-coding a directory separator character. @@ -2535,7 +2535,7 @@ The following example illustrates the difference in the paths returned by the . -If `path1` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: +If `path1` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: - Retrieve the value of the property rather than hard-coding a directory separator character. @@ -2594,7 +2594,7 @@ Not all invalid characters for directory and file names are interpreted as unacc This method simply concatenates `path`, `path2`, and `path3` and adds a directory separator character between any of the path components if one is not already present. If the of any of `path1`, `path2`, or `path3` arguments is zero, the method concatenates the remaining arguments. If the of all components is zero, the method returns . -If `path1` or `path2` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: +If `path1` or `path2` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: - Retrieve the value of the property rather than hard-coding a directory separator character. @@ -2660,7 +2660,7 @@ The following example illustrates the difference in the paths returned by the . -If `path1` or `path2` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: +If `path1` or `path2` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: - Retrieve the value of the property rather than hard-coding a directory separator character. @@ -2720,7 +2720,7 @@ Not all invalid characters for directory and file names are interpreted as unacc This method simply concatenates `path`, `path2`, `path3` and `path4` and adds a directory separator character between any of the path components if one is not already present. If the of any of `path1`, `path2`, `path3` or `path4` argument is zero, the method concatenates the remaining arguments. If the of all components is zero, the method returns . -If `path1` or `path2` or `path3` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: +If `path1` or `path2` or `path3` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: - Retrieve the value of the property rather than hard-coding a directory separator character. @@ -2780,7 +2780,7 @@ Not all invalid characters for directory and file names are interpreted as unacc This method simply concatenates `path`, `path2`, `path3` and `path4` and adds a directory separator character between any of the path components if one is not already present. If the length of any of `path1`, `path2`, `path3` or `path4` argument is zero, the method concatenates the remaining arguments. If the length of the resulting concatenated string is zero, the method returns . -If `path1` or `path2` or `path3` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: +If `path1` or `path2` or `path3` ends in a path separator character that is not appropriate for the target platform, the `Join` method preserves the original path separator character and appends the supported one. This issue arises in hard-coded paths that use the Windows backslash ("\\") character, which is not recognized as a path separator on Unix-based systems. To work around this issue, you can: - Retrieve the value of the property rather than hard-coding a directory separator character. diff --git a/xml/System.Reflection/PropertyInfo.xml b/xml/System.Reflection/PropertyInfo.xml index 4c051c0d257..92e848201c0 100644 --- a/xml/System.Reflection/PropertyInfo.xml +++ b/xml/System.Reflection/PropertyInfo.xml @@ -1140,21 +1140,9 @@ The method for this property. - The accessor is public. + The accessor is public, OR is and the accessor is non-public. - -or- - - is and the accessor is non-public. - - is , but the property is read-only. - - -or- - - is and the accessor is non-public. - - -or- - - There is no accessor. + is , but the property is read-only, OR is and the accessor is non-public, OR there is no accessor. diff --git a/xml/System.Runtime.InteropServices/_PropertyInfo.xml b/xml/System.Runtime.InteropServices/_PropertyInfo.xml index 71c190fbc2a..754df0c7f2b 100644 --- a/xml/System.Runtime.InteropServices/_PropertyInfo.xml +++ b/xml/System.Runtime.InteropServices/_PropertyInfo.xml @@ -695,23 +695,10 @@ A object representing the method for this property. - The accessor is public. + The accessor is public, OR the parameter is and the accessor is non-public. - -or- - - The parameter is and the accessor is non-public. - - The parameter is , but the property is read-only. - - -or- - - The parameter is and the accessor is non-public. - - -or- - - There is no accessor. - - + The parameter is , but the property is read-only, OR the parameter is and the accessor is non-public, OR there is no accessor. + Returns a valueindicating that it is not possible to XAML serialize the extended protection policy. - . + To be added. diff --git a/xml/System.ServiceModel.Dispatcher/XPathResult.xml b/xml/System.ServiceModel.Dispatcher/XPathResult.xml index 26eb6658979..35c959d109b 100644 --- a/xml/System.ServiceModel.Dispatcher/XPathResult.xml +++ b/xml/System.ServiceModel.Dispatcher/XPathResult.xml @@ -76,7 +76,7 @@ Returns the result of the XPath query as a Boolean value. - . + To be added. @@ -132,7 +132,7 @@ Returns the result of the XPath query as a number. - . + To be added. diff --git a/xml/System.ServiceModel/EndpointAddress10.xml b/xml/System.ServiceModel/EndpointAddress10.xml index d35867f0e41..bbb67ab275f 100644 --- a/xml/System.ServiceModel/EndpointAddress10.xml +++ b/xml/System.ServiceModel/EndpointAddress10.xml @@ -146,7 +146,7 @@ Returns . - . + To be added. diff --git a/xml/System.ServiceModel/EndpointAddressAugust2004.xml b/xml/System.ServiceModel/EndpointAddressAugust2004.xml index 08c60e80268..1431bf37c38 100644 --- a/xml/System.ServiceModel/EndpointAddressAugust2004.xml +++ b/xml/System.ServiceModel/EndpointAddressAugust2004.xml @@ -144,7 +144,7 @@ Returns . - . + To be added. diff --git a/xml/System.Text/Rune.xml b/xml/System.Text/Rune.xml index 2dbe6d69daf..4bb48224c1a 100644 --- a/xml/System.Text/Rune.xml +++ b/xml/System.Text/Rune.xml @@ -544,7 +544,7 @@ This method is very similar to if the source buffer is empty or contains only a standalone UTF-8 high surrogate character. then contains , and contains the length of the input buffer. if the source buffer ends with an ill-formed UTF-8 encoded scalar value. then contains , and contains the number of values used in the input buffer to encode the ill-formed sequence. - . + Queues a method specified by an delegate for execution, and provides data to be used by the method. The method executes when a thread pool thread becomes available. if the method is successfully queued; is thrown if the work item could not be queued. - . + To be added. diff --git a/xml/System.Web.UI.MobileControls/StyleSheet.xml b/xml/System.Web.UI.MobileControls/StyleSheet.xml index fe0237581ed..952f0b20c55 100644 --- a/xml/System.Web.UI.MobileControls/StyleSheet.xml +++ b/xml/System.Web.UI.MobileControls/StyleSheet.xml @@ -797,11 +797,7 @@ Condition - The property was accessed at run time. - - -or- - - An attempt was made to set the property. + The property was accessed at run time, or an attempt was made to set the property. diff --git a/xml/System.Windows.Controls/MenuScrollingVisibilityConverter.xml b/xml/System.Windows.Controls/MenuScrollingVisibilityConverter.xml index 83cea6ccef4..48525611772 100644 --- a/xml/System.Windows.Controls/MenuScrollingVisibilityConverter.xml +++ b/xml/System.Windows.Controls/MenuScrollingVisibilityConverter.xml @@ -143,7 +143,7 @@ Not supported. - . + To be added. diff --git a/xml/System.Windows.Documents.DocumentStructures/SectionStructure.xml b/xml/System.Windows.Documents.DocumentStructures/SectionStructure.xml index e30fba5889c..93ec58122c0 100644 --- a/xml/System.Windows.Documents.DocumentStructures/SectionStructure.xml +++ b/xml/System.Windows.Documents.DocumentStructures/SectionStructure.xml @@ -114,7 +114,7 @@ This method has not been implemented. - . + To be added. diff --git a/xml/System.Windows.Forms/KeysConverter.xml b/xml/System.Windows.Forms/KeysConverter.xml index 11d58eaae50..32fd78e1d4c 100644 --- a/xml/System.Windows.Forms/KeysConverter.xml +++ b/xml/System.Windows.Forms/KeysConverter.xml @@ -206,7 +206,7 @@ is less than . - zero + 0 equals . diff --git a/xml/System.Xml/XmlDocumentXPathExtensions.xml b/xml/System.Xml/XmlDocumentXPathExtensions.xml index 0fdadb716e9..c347cf97d2a 100644 --- a/xml/System.Xml/XmlDocumentXPathExtensions.xml +++ b/xml/System.Xml/XmlDocumentXPathExtensions.xml @@ -16,7 +16,7 @@ - To be added. + Provides extension methods for the and for document navigation. To be added. @@ -41,9 +41,9 @@ - To be added. - To be added. - To be added. + The document from which the XPath navigator is created. + Creates a new XPath navigator object for navigating the specified document. + An XPath navigator object. To be added. @@ -68,9 +68,9 @@ - To be added. - To be added. - To be added. + The node where the navigator is initially positioned. + Creates an XPath navigator for navigating the specified node. + An XPath navigator object used to navigate the node. The XPath navigator is positioned on the node from which the method is called, not on the root of the document. To be added. @@ -96,10 +96,10 @@ - To be added. - To be added. - To be added. - To be added. + The document from which the XPath navigator is created. + The node where the navigator is initially positioned. + Creates an XPath navigator object for navigating the specified document positioned on the specified node. + An XPath navigator object. To be added. @@ -125,10 +125,10 @@ - To be added. - To be added. - To be added. - To be added. + The node where the navigator is initially positioned. + The XPath expression to match. + Selects a list of nodes matching the specified XPath expression. + A collection of nodes that match the specified XPath expression. To be added. @@ -155,12 +155,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The node where the navigator is initially positioned. + The XPath expression to match. + A namespace manager to resolve XPath expression prefix namespaces. + Selects a list of nodes matching the specified XPath expression. Any prefixes found in the XPath expression are resolved using the supplied namespace manager. + A collection of nodes that match the specified XPath expression. To be added. + XPath examples @@ -185,11 +186,12 @@ - To be added. - To be added. - To be added. - To be added. + The node where the navigator is initially positioned. + The XPath expression to match. + Selects the first node that matches the XPath expression. + The first node that matches the XPath query, or if no matching node is found. To be added. + XPath examples @@ -215,12 +217,13 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The node where the navigator is initially positioned. + The XPath expression to match. + A namespace manager to resolve XPath expression prefix namespaces. + Selects the first node that matches the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied namespace manager. + The first node that matches the XPath query, or if no matching node is found. To be added. + XPath examples @@ -244,9 +247,9 @@ - To be added. - To be added. - To be added. + The node in which the implementation should position newly created navigators. + Creates an instance used for producing navigators. + An instance. To be added. diff --git a/xml/System/Byte.xml b/xml/System/Byte.xml index c20b257fc56..9333898beaf 100644 --- a/xml/System/Byte.xml +++ b/xml/System/Byte.xml @@ -307,13 +307,8 @@ Greater than zero - This instance is greater than . - - -or- - - is . - - + This instance is greater than , or is . + Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . diff --git a/xml/System/Double.xml b/xml/System/Double.xml index 2337501fd50..2e96ee6757e 100644 --- a/xml/System/Double.xml +++ b/xml/System/Double.xml @@ -362,27 +362,15 @@ Less than zero - This instance is less than . - - -or- - - This instance is not a number () and is a number. + This instance is less than , or this instance is not a number () and is a number. Zero - This instance is equal to . - - -or- - - Both this instance and are not a number (), , or . + This instance is equal to , or both this instance and are not a number (), , or . Greater than zero - This instance is greater than . - - -or- - - This instance is a number and is not a number (). + This instance is greater than , or this instance is a number and is not a number (). @@ -469,31 +457,15 @@ A negative integer - This instance is less than . - - -or- - - This instance is not a number () and is a number. + This instance is less than , or this instance is not a number () and is a number. Zero - This instance is equal to . + This instance is equal to , or this instance and are both , , or A positive integer - -or- - - This instance and are both , , or A positive integer - - This instance is greater than . - - -or- - - This instance is a number and is not a number (). - - -or- - - is . - - + This instance is greater than , OR this instance is a number and is not a number (), OR is . + + Greater than zero - The value of this instance is greater than the value of . - - -or- - - is . - - + + The value of this instance is greater than the value of , or is . + Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . @@ -1112,11 +1108,7 @@ An object to compare, or . Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the object. A signed number indicating the relative values of this instance and . - Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than . - --or- - - is . + Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than , or is . Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . @@ -1192,11 +1188,25 @@ An object to compare, or . Compares this instance to a specified object and returns an indication of their relative values. A signed number indicating the relative values of this instance and . - Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than . - --or- - - is . + + + Return Value + Description + + + Less than zero + This instance is less than . + + + Zero + This instance is equal to . + + + Greater than zero + This instance is greater than , or is . + + + Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . @@ -1136,11 +1132,7 @@ An object to compare, or . Compares this instance to a specified object and returns an indication of their relative values. A signed number indicating the relative values of this instance and . - Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than . - --or- - - is . + Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than , or is . if < .`` + if < . -or- @@ -2739,7 +2739,8 @@ Remainder = (Math.Abs(dividend) - (Math.Abs(divisor) * Zero - Equal to or or + Equal to or or + Less than zero - The property for is , and the property for is . - - -or- - - The properties for and are , and the value of the property for is less than the value of the property for . + The property for is , and the property for is , or the properties for and are , and the value of the property for is less than the value of the property for . Zero - The properties for and are . - - -or- - - The properties for and are , and the value of the property for is equal to the value of the property for . + The properties for and are , or the properties for and are , and the value of the property for is equal to the value of the property for . Greater than zero - The property for is , and the property for is . - - -or- - - The properties for and are , and the value of the property for is greater than the value of the property for . + The property for is , and the property for is , or the properties for and are , and the value of the property for is greater than the value of the property for . To be added. @@ -223,17 +211,9 @@ Description - The properties for and are . - - -or- - - The properties for and are , and the properties of the parameters are equal. - - The property is for one parameter and for the other parameter. - - -or- + The properties for and are , or the properties for and are , and the properties of the parameters are equal. - The properties for and are , and the properties of the parameters are unequal. + The property is for one parameter and for the other parameter, or the properties for and are , and the properties of the parameters are unequal. To be added. diff --git a/xml/System/Nullable`1.xml b/xml/System/Nullable`1.xml index 3daa1b43c71..0a71b39a885 100644 --- a/xml/System/Nullable`1.xml +++ b/xml/System/Nullable`1.xml @@ -194,30 +194,16 @@ Description - The property is , and the parameter is . That is, two null values are equal by definition. + The property is , and the parameter is (that is, two null values are equal by definition), OR the property is , and the value returned by the property is equal to the parameter. - -or- - - The property is , and the value returned by the property is equal to the parameter. - - The property for the current structure is , and the parameter is . - - -or- - - The property for the current structure is , and the parameter is not . - - -or- - - The property for the current structure is , and the value returned by the property is not equal to the parameter. + The property for the current structure is , and the parameter is , OR the property for the current structure is , and the parameter is not , OR the property for the current structure is , and the value returned by the property is not equal to the parameter. property of the current structure is `true` and the `other` argument is not `null`, equality is determined by passing the `other` parameter to the `Equals` method of the underlying value of the current structure. - - + If the property of the current structure is `true` and the `other` argument is not `null`, equality is determined by passing the `other` parameter to the `Equals` method of the underlying value of the current structure. ## Examples The following code example determines whether an object and a object are equal to the current object. diff --git a/xml/System/SByte.xml b/xml/System/SByte.xml index 448cae5f736..d0c4ccf58aa 100644 --- a/xml/System/SByte.xml +++ b/xml/System/SByte.xml @@ -166,11 +166,7 @@ Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . diff --git a/xml/System/Single.xml b/xml/System/Single.xml index ac72ac6aa68..5ad942f1ed5 100644 --- a/xml/System/Single.xml +++ b/xml/System/Single.xml @@ -356,33 +356,17 @@ Less than zero - This instance is less than . - - -or- - - This instance is not a number () and is a number. + This instance is less than , or this instance is not a number () and is a number. Zero - This instance is equal to . - - -or- - - This instance and value are both not a number (), , or . + This instance is equal to , or this instance and value are both not a number (), , or . Greater than zero - This instance is greater than . - - -or- - - This instance is a number and is not a number (). - - -or- - - is . - - + This instance is greater than , OR this instance is a number and is not a number (), OR is . + + Less than zero - This instance is less than . - - -or- - - This instance is not a number () and is a number. + This instance is less than , or this instance is not a number () and is a number. Zero - This instance is equal to . - - -or- - - Both this instance and are not a number (), , or . + This instance is equal to , or both this instance and are not a number (), , or . Greater than zero - This instance is greater than . - - -or- - - This instance is a number and is not a number (). + This instance is greater than , or this instance is a number and is not a number (). diff --git a/xml/System/String.xml b/xml/System/String.xml index 480e7ed810a..c1f1eb91831 100644 --- a/xml/System/String.xml +++ b/xml/System/String.xml @@ -12616,11 +12616,7 @@ The following example defines a `StripStartTags` method that uses the Compares this instance with a specified and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified . A 32-bit signed integer that indicates whether this instance precedes, follows, or appears in the same position in the sort order as the parameter. -ValueConditionLess than zeroThis instance precedes .ZeroThis instance has the same position in the sort order as .Greater than zeroThis instance follows . - --or- - - is . +ValueConditionLess than zeroThis instance precedes .ZeroThis instance has the same position in the sort order as .Greater than zeroThis instance follows , or is . Less than zero - precedes in the sort order. - - -or- - - is and is not . + precedes in the sort order, or is and is not . Zero - is equal to . - - -or- - - and are both . + is equal to , or and are both . Greater than zero - follows in the sort order. - - -or- - - is and is not . + follows in the sort order, or is and is not . @@ -280,27 +268,15 @@ The following example demonstrates the properties and the Less than zero - precedes in the sort order. - - -or- - - is and is not . + precedes in the sort order, or is and is not . Zero - is equal to . - - -or- - - and are both . + is equal to , or and are both . Greater than zero - follows in the sort order. - - -or- - - is and is not . + follows in the sort order, or is and is not . diff --git a/xml/System/TimeSpan.xml b/xml/System/TimeSpan.xml index 85d8e335a8a..468f574d789 100644 --- a/xml/System/TimeSpan.xml +++ b/xml/System/TimeSpan.xml @@ -648,11 +648,7 @@ 1 - This instance is longer than . - - -or- - - is . + This instance is longer than , or is . @@ -3722,11 +3718,7 @@ When a time interval component in the string to be parsed contains more than sev Compares this instance to a specified object and returns an integer that indicates whether this instance is shorter than, equal to, or longer than the specified object. One of the following values: - ValueDescription-1This instance is shorter than .0This instance is equal to .1This instance is longer than . - --or- - - is . + ValueDescription-1This instance is shorter than .0This instance is equal to .1This instance is longer than , or is . Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . @@ -1169,11 +1165,7 @@ An object to compare, or . Compares this instance to a specified object and returns an indication of their relative values. A signed number indicating the relative values of this instance and . - Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than . - --or- - - is . + Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than , or is . Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . @@ -1182,11 +1178,7 @@ An object to compare, or . Compares this instance to a specified object and returns an indication of their relative values. A signed number indicating the relative values of this instance and . - Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than . - --or- - - is . + Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than , or is . Greater than zero - This instance is greater than . - - -or- - - is . + This instance is greater than , or is . @@ -1163,11 +1159,7 @@ An object to compare, or . Compares this instance to a specified object and returns an indication of their relative values. A signed number indicating the relative values of this instance and . - Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than . - --or- - - is . + Return ValueDescriptionLess than zeroThis instance is less than .ZeroThis instance is equal to .Greater than zeroThis instance is greater than , or is . Greater than zero - The current object is a version subsequent to . - - -or- - - is . + The current object is a version subsequent to , or is . @@ -722,11 +718,7 @@ Greater than zero - The current object is a version subsequent to . - - -or- - - is . + The current object is a version subsequent to , or is . @@ -1670,11 +1662,7 @@ where `major`, `minor`, `build`, and `revision` are the string representations o An object to compare, or . Compares the current object to a specified object and returns an indication of their relative values. A signed integer that indicates the relative values of the two objects, as shown in the following table: - Return valueMeaningLess than zeroThe current object is a version before .ZeroThe current object is the same version as .Greater than zeroThe current object is a version subsequent to . - --or- - - is . + Return valueMeaningLess than zeroThe current object is a version before .ZeroThe current object is the same version as .Greater than zeroThe current object is a version subsequent to , or is .