From bd3f98591fc6ccc8800c9054cce95d9a4e2a4e5f Mon Sep 17 00:00:00 2001 From: NextTurn <45985406+NextTurn@users.noreply.github.com> Date: Mon, 1 Jun 2020 00:00:00 +0800 Subject: [PATCH 1/2] Collapse relative links, Part 32 --- .../developing-apps/accessing-data.md | 2 +- ...izing-which-objects-are-available-in-my.md | 14 +- ...ding-the-visual-basic-application-model.md | 2 +- ...ging-and-deploying-custom-my-extensions.md | 8 +- ...provided-by-my-forms-and-my-webservices.md | 8 +- .../how-my-depends-on-project-type.md | 14 +- .../development-with-my/index.md | 16 +- ...w-of-the-visual-basic-application-model.md | 2 +- ...-my-application-my-computer-and-my-user.md | 2 +- ...pment-with-my-resources-and-my-settings.md | 8 +- docs/visual-basic/developing-apps/index.md | 16 +- .../accessing-application-forms.md | 4 +- .../accessing-application-web-services.md | 6 +- .../how-to-change-user-settings.md | 12 +- ...create-property-grids-for-user-settings.md | 12 +- .../how-to-persist-user-settings.md | 10 +- .../how-to-read-application-settings.md | 10 +- .../programming/app-settings/index.md | 10 +- .../accessing-the-computer-s-ports.md | 10 +- .../accessing-the-keyboard.md | 2 +- ...create-a-registry-key-and-set-its-value.md | 2 +- .../how-to-delete-a-registry-key.md | 4 +- ...to-dial-modems-attached-to-serial-ports.md | 12 +- .../how-to-download-a-file.md | 4 +- ...how-to-read-a-value-from-a-registry-key.md | 2 +- ...ow-to-receive-strings-from-serial-ports.md | 10 +- .../how-to-send-strings-to-serial-ports.md | 8 +- .../how-to-show-available-serial-ports.md | 8 +- .../how-to-upload-a-file.md | 4 +- .../programming/computer-resources/index.md | 16 +- .../performing-network-operations.md | 6 +- .../port-operations-in-the-net-framework.md | 2 +- ...try-using-the-microsoft-win32-namespace.md | 6 +- ...eading-from-and-writing-to-the-registry.md | 10 +- .../security-and-the-registry.md | 2 +- ...t-framework-file-io-and-the-file-system.md | 4 +- ...t-framework-file-io-and-the-file-system.md | 2 +- ...leting-and-moving-files-and-directories.md | 32 +- .../drives-directories-files/file-access.md | 14 +- .../file-encodings.md | 4 +- .../how-to-append-to-text-files.md | 2 +- ...o-copy-a-directory-to-another-directory.md | 4 +- ...-with-a-specific-pattern-to-a-directory.md | 6 +- ...copy-of-a-file-in-a-different-directory.md | 8 +- ...-a-copy-of-a-file-in-the-same-directory.md | 8 +- .../how-to-create-a-directory.md | 2 +- .../how-to-delete-a-file.md | 2 +- ...w-to-find-files-with-a-specific-pattern.md | 6 +- ...-subdirectories-with-a-specific-pattern.md | 2 +- ...-the-collection-of-files-in-a-directory.md | 4 +- .../how-to-move-a-file.md | 6 +- .../how-to-parse-file-paths.md | 2 +- .../how-to-read-from-binary-files.md | 6 +- ...to-read-from-comma-delimited-text-files.md | 10 +- ...how-to-read-from-fixed-width-text-files.md | 10 +- .../how-to-read-from-text-files.md | 14 +- ...ead-text-from-files-with-a-streamreader.md | 2 +- .../how-to-rename-a-file.md | 8 +- ...write-text-to-files-with-a-streamwriter.md | 4 +- .../how-to-write-text-to-files.md | 2 +- .../how-to-write-to-binary-files.md | 2 +- .../drives-directories-files/index.md | 10 +- ...t-files-with-the-textfieldparser-object.md | 2 +- .../reading-from-files.md | 20 +- ...-reading-from-and-writing-to-text-files.md | 10 +- ...ough-manipulating-files-and-directories.md | 2 +- ...ng-files-by-using-net-framework-methods.md | 2 +- .../writing-to-files.md | 18 +- .../developing-apps/programming/index.md | 20 +- .../log-info/how-to-log-exceptions.md | 8 +- ...en-the-application-starts-or-shuts-down.md | 2 +- ...-write-event-information-to-a-text-file.md | 6 +- .../log-info/how-to-write-log-messages.md | 14 +- ...ow-to-write-to-an-application-event-log.md | 10 +- .../programming/log-info/index.md | 22 +- .../log-info/troubleshooting-log-listeners.md | 10 +- ...e-my-application-log-writes-information.md | 8 +- ...lkthrough-creating-custom-log-listeners.md | 8 +- ...e-my-application-log-writes-information.md | 12 +- ...ugh-filtering-my-application-log-output.md | 14 +- .../log-info/working-with-application-logs.md | 6 +- .../developing-apps/windows-forms/index.md | 2 +- .../getting-started/additional-resources.md | 2 +- .../visual-basic/getting-started/whats-new.md | 14 +- .../language-reference/attributes.md | 2 +- .../constants-and-enumerations.md | 8 +- .../data-types/boolean-data-type.md | 16 +- .../data-types/byte-data-type.md | 8 +- .../data-types/char-data-type.md | 14 +- .../data-types/date-data-type.md | 8 +- .../data-types/decimal-data-type.md | 12 +- .../data-types/double-data-type.md | 18 +- .../language-reference/data-types/index.md | 44 +- .../data-types/integer-data-type.md | 12 +- .../data-types/long-data-type.md | 12 +- .../data-types/object-data-type.md | 12 +- .../data-types/sbyte-data-type.md | 14 +- .../data-types/short-data-type.md | 12 +- .../data-types/single-data-type.md | 16 +- .../data-types/string-data-type.md | 14 +- .../data-types/uinteger-data-type.md | 10 +- .../data-types/ulong-data-type.md | 10 +- .../data-types/user-defined-data-type.md | 22 +- .../data-types/ushort-data-type.md | 10 +- .../directives/const-directive.md | 10 +- .../directives/externalsource-directive.md | 2 +- .../directives/if-then-else-directives.md | 6 +- .../language-reference/directives/index.md | 10 +- .../directives/region-directive.md | 4 +- ...alid-comment-token-for-delimited-fields.md | 2 +- ...include-a-reference-to-a-private-object.md | 2 +- .../a-startup-form-has-not-been-specified.md | 2 +- .../error-messages/argument-not-optional.md | 2 +- ...tename-cannot-be-applied-multiple-times.md | 4 +- ...e-the-format-of-the-guid-is-not-correct.md | 2 +- .../error-messages/automation-error.md | 2 +- .../bad-dll-calling-convention.md | 6 +- .../error-messages/bad-file-mode.md | 2 +- .../error-messages/bad-file-name-or-number.md | 2 +- .../error-messages/bc2012.md | 2 +- .../error-messages/bc30306.md | 2 +- .../error-messages/bc30310.md | 2 +- .../error-messages/bc30828.md | 4 +- .../error-messages/bc42358.md | 2 +- .../can-t-create-necessary-temporary-file.md | 2 +- .../cannot-create-activex-component.md | 2 +- ...-or-does-not-support-expected-interface.md | 2 +- ...ment-must-end-with-a-matching-end-class.md | 4 +- ...sion-not-representable-in-type-typename.md | 4 +- ...t-be-of-an-intrinsic-or-enumerated-type.md | 6 +- .../constructor-name-cannot-call-itself.md | 2 +- ...r-back-to-the-matching-argument-narrows.md | 24 +- ...eclared-without-explicit-delegate-types.md | 6 +- ...cannot-be-inferred-from-these-arguments.md | 6 +- .../error-messages/declaration-expected.md | 4 +- ...cts-with-default-property-propertyname2.md | 4 +- ...te-class-classname-has-no-invoke-method.md | 8 +- ...-classes-cannot-raise-base-class-events.md | 4 +- .../error-messages/device-i-o-error.md | 2 +- ...ntname-is-obsolete-visual-basic-warning.md | 2 +- ...-be-preceded-by-a-matching-if-or-elseif.md | 2 +- .../end-of-statement-expected.md | 4 +- .../error-messages/error-in-loading-dll.md | 2 +- ...ompiling-the-xml-schemas-in-the-project.md | 2 +- ...implement-event-eventname2-on-interface.md | 6 +- ...-an-event-and-cannot-be-called-directly.md | 2 +- ...-a-delegate-type-that-has-a-return-type.md | 2 +- ...cannot-be-handled-by-non-shared-methods.md | 4 +- ...ion-cannot-be-used-as-a-type-constraint.md | 8 +- .../expression-does-not-produce-a-value.md | 2 +- ...ype-typename-which-is-a-restricted-type.md | 2 +- ...e-cannot-be-the-target-of-an-assignment.md | 6 +- ...xpression-of-type-type-is-not-queryable.md | 10 +- ...ls-the-containing-property-propertyname.md | 8 +- .../error-messages/expression-too-complex.md | 2 +- ...-to-module-sub-or-function-declarations.md | 6 +- ...-is-too-large-to-read-into-a-byte-array.md | 6 +- ...e-not-found-during-automation-operation.md | 2 +- ...e-not-found-visual-basic-run-time-error.md | 2 +- ...on-must-be-nullable-or-a-reference-type.md | 6 +- ...licit-call-to-mybase-new-or-myclass-new.md | 2 +- ...-be-a-call-to-mybase-new-or-myclass-new.md | 2 +- .../for-each-on-type-typename-is-ambiguous.md | 6 +- .../function-evaluation-is-disabled.md | 4 +- ...oesn-t-return-a-value-on-all-code-paths.md | 8 +- ...mart-device-visual-basic-compiler-error.md | 2 +- ...rameter-types-must-be-class-constrained.md | 12 +- ...property-propertyname-is-not-accessible.md | 12 +- ...-requires-a-withevents-variable-defined.md | 2 +- .../error-messages/identifier-expected.md | 4 +- .../error-messages/identifier-is-too-long.md | 2 +- ...-from-typename1-to-typename2-in-copying.md | 12 +- .../error-messages/index.md | 4 +- .../error-messages/initializer-expected.md | 4 +- ...s-already-implemented-by-the-base-class.md | 4 +- ...ires-operands-that-have-reference-types.md | 6 +- ...of-type-can-only-be-compared-to-nothing.md | 4 +- ...is-valid-only-within-an-instance-method.md | 6 +- ...-are-numbers-must-be-followed-by-colons.md | 2 +- ...-not-be-removed-from-this-event-handler.md | 6 +- ...-in-the-first-expression-of-select-case.md | 6 +- ...-resolution;-runtime-errors-could-occur.md | 6 +- ...d-overload-resolution-cannot-be-applied.md | 6 +- ...can-only-appear-inside-a-with-statement.md | 4 +- .../error-messages/line-is-too-long.md | 2 +- ...r-supported-visual-basic-compiler-error.md | 2 +- ...xpose-type-typename-outside-the-project.md | 2 +- ...biguous-across-the-inherited-interfaces.md | 2 +- ...-also-be-due-to-mixing-a-file-reference.md | 2 +- ...-signature-compatible-with-the-delegate.md | 8 +- ...e-definitions-with-identical-signatures.md | 4 +- ...ot-be-used-as-operands-of-the-addressof.md | 6 +- ...n-occur-only-at-file-or-namespace-level.md | 2 +- ...mbiguous-in-the-namespace-namespacename.md | 4 +- .../name-membername-is-not-cls-compliant.md | 6 +- .../name-name-is-not-declared.md | 8 +- ...-fullnamespacename-is-not-cls-compliant.md | 12 +- ...rted-from-the-namespaces-or-types-name2.md | 6 +- ...ied-in-the-imports-qualifiedelementname.md | 12 +- ...ject-level-imports-qualifiedelementname.md | 8 +- .../need-property-array-index.md | 2 +- ...nature-that-is-compatible-with-delegate.md | 4 +- ...appropriate-signature-was-found-in-name.md | 4 +- ...ot-allowed-in-a-cls-compliant-interface.md | 2 +- ...erence-is-not-supported-in-this-context.md | 4 +- ...mber-of-dimensions-of-the-indexed-array.md | 2 +- ...lass-does-not-support-the-set-of-events.md | 4 +- .../error-messages/object-required.md | 2 +- ...variable-or-with-block-variable-not-set.md | 8 +- .../operator-declaration-must-be-one-of.md | 10 +- .../error-messages/optional-expected.md | 2 +- .../error-messages/ordinal-is-not-valid.md | 2 +- ...t-of-memory-visual-basic-compiler-error.md | 2 +- .../error-messages/out-of-string-space.md | 4 +- .../overflow-visual-basic-error.md | 2 +- .../overflow-visual-basic-run-time-error.md | 4 +- .../error-messages/path-file-access-error.md | 2 +- .../error-messages/path-not-found.md | 2 +- .../error-messages/permission-denied.md | 2 +- ...procedure-call-or-argument-is-not-valid.md | 2 +- .../property-array-index-is-not-valid.md | 2 +- .../error-messages/property-not-found.md | 2 +- .../property-or-method-not-found.md | 2 +- ...oesn-t-return-a-value-on-all-code-paths.md | 10 +- .../range-variable-name-can-be-inferred.md | 4 +- ...-hides-a-variable-in-an-enclosing-block.md | 10 +- ...g-type-but-suitable-reference-not-found.md | 2 +- ...-within-method-bodies-multiline-lambdas.md | 2 +- .../error-messages/resume-without-error.md | 4 +- ...tion-procedurename-is-not-cls-compliant.md | 8 +- ...property-propertyname-is-not-accessible.md | 12 +- ...-a-block-outside-of-a-line-if-statement.md | 2 +- .../statement-is-not-valid-in-a-namespace.md | 4 +- ...-valid-inside-a-method-multiline-lambda.md | 8 +- ...-constants-must-end-with-a-double-quote.md | 2 +- .../structure-structurename-must-contain.md | 8 +- .../sub-main-was-not-found-in-name.md | 6 +- .../sub-or-function-not-defined.md | 6 +- .../error-messages/subscript-out-of-range.md | 2 +- ...er-is-unable-to-complete-read-operation.md | 4 +- ...iable-variablename-will-not-be-inferred.md | 12 +- ...is-array-is-fixed-or-temporarily-locked.md | 2 +- ...ated-with-an-element-of-this-collection.md | 2 +- .../error-messages/too-many-files.md | 2 +- ...could-not-be-inferred-from-the-delegate.md | 10 +- .../error-messages/type-mismatch.md | 2 +- ...-member-membername-is-not-cls-compliant.md | 8 +- ...optional-parameter-is-not-cls-compliant.md | 10 +- ...eter-parametername-is-not-cls-compliant.md | 8 +- ...type-of-variablename-cannot-be-inferred.md | 12 +- .../type-typename-has-no-constructors.md | 2 +- .../type-typename-is-not-cls-compliant.md | 8 +- .../type-typename-is-not-defined.md | 10 +- ...must-implement-membername-for-interface.md | 4 +- ...-methodname-for-interface-interfacename.md | 4 +- ...e-cannot-inherit-from-type-basetypename.md | 8 +- .../typename-is-a-delegate-type.md | 8 +- ...ype-and-cannot-be-used-as-an-expression.md | 2 +- ...e-typename-of-enum-is-not-cls-compliant.md | 8 +- ...-expression-may-have-unexpected-results.md | 2 +- ...type-type1-cannot-be-converted-to-type2.md | 6 +- ...nnot-be-converted-to-typename2-multiple.md | 2 +- ...ename1-cannot-be-converted-to-typename2.md | 2 +- ...e-uses-an-automation-type-not-supported.md | 2 +- ...-hides-a-variable-in-an-enclosing-block.md | 4 +- ...sed-before-it-has-been-assigned-a-value.md | 10 +- ...-properties-do-not-support-late-binding.md | 4 +- ...nt-exception-must-have-a-cref-attribute.md | 6 +- ...xml-entity-references-are-not-supported.md | 6 +- ...ot-supported-in-embedded-code-in-aspnet.md | 6 +- ...pace-uri-uri-can-be-bound-only-to-xmlns.md | 6 +- .../functions/conversion-functions.md | 38 +- .../functions/ctype-function.md | 16 +- .../language-reference/functions/index.md | 14 +- .../return-values-for-the-cstr-function.md | 12 +- .../functions/string-functions.md | 8 +- .../functions/type-conversion-functions.md | 46 +- docs/visual-basic/language-reference/index.md | 42 +- .../keywords/arrays-summary.md | 8 +- .../keywords/collection-object-summary.md | 4 +- .../keywords/control-flow-summary.md | 14 +- .../keywords/conversion-summary.md | 6 +- .../keywords/data-types-summary.md | 8 +- .../keywords/dates-and-times-summary.md | 4 +- .../declarations-and-constants-summary.md | 22 +- .../keywords/derived-math-functions.md | 2 +- .../keywords/directories-and-files-summary.md | 12 +- .../keywords/errors-summary.md | 8 +- .../keywords/financial-summary.md | 4 +- .../language-reference/keywords/index.md | 12 +- .../information-and-interaction-summary.md | 4 +- .../keywords/input-and-output-summary.md | 4 +- .../keywords/math-summary.md | 6 +- .../keywords/my-reference.md | 16 +- .../keywords/operators-summary.md | 16 +- .../keywords/registry-summary.md | 6 +- .../keywords/string-manipulation-summary.md | 6 +- .../language-reference/modifiers/ansi.md | 10 +- .../language-reference/modifiers/assembly.md | 6 +- .../language-reference/modifiers/async.md | 20 +- .../language-reference/modifiers/auto.md | 12 +- .../language-reference/modifiers/byref.md | 10 +- .../language-reference/modifiers/byval.md | 14 +- .../language-reference/modifiers/default.md | 8 +- .../language-reference/modifiers/friend.md | 42 +- .../language-reference/modifiers/index.md | 76 +-- .../language-reference/modifiers/iterator.md | 12 +- .../language-reference/modifiers/key.md | 8 +- .../modifiers/module-keyword.md | 10 +- .../modifiers/mustinherit.md | 10 +- .../modifiers/mustoverride.md | 22 +- .../language-reference/modifiers/narrowing.md | 14 +- .../modifiers/notinheritable.md | 8 +- .../modifiers/notoverridable.md | 22 +- .../language-reference/modifiers/optional.md | 20 +- .../modifiers/out-generic-modifier.md | 2 +- .../language-reference/modifiers/overloads.md | 20 +- .../modifiers/overridable.md | 24 +- .../language-reference/modifiers/overrides.md | 26 +- .../modifiers/paramarray.md | 16 +- .../language-reference/modifiers/partial.md | 38 +- .../modifiers/private-protected.md | 42 +- .../language-reference/modifiers/private.md | 40 +- .../modifiers/protected-friend.md | 14 +- .../language-reference/modifiers/protected.md | 40 +- .../language-reference/modifiers/public.md | 44 +- .../language-reference/modifiers/readonly.md | 2 +- .../language-reference/modifiers/shadows.md | 48 +- .../language-reference/modifiers/shared.md | 30 +- .../language-reference/modifiers/static.md | 18 +- .../language-reference/modifiers/unicode.md | 10 +- .../language-reference/modifiers/widening.md | 18 +- .../modifiers/withevents.md | 8 +- .../language-reference/modifiers/writeonly.md | 12 +- .../language-reference/modules.md | 2 +- .../language-reference/objects/index.md | 14 +- .../objects/my-application-info-object.md | 2 +- .../objects/my-application-log-object.md | 4 +- .../objects/my-application-object.md | 4 +- .../objects/my-computer-audio-object.md | 4 +- .../objects/my-computer-clipboard-object.md | 4 +- .../objects/my-computer-clock-object.md | 2 +- .../objects/my-computer-filesystem-object.md | 6 +- ...er-filesystem-specialdirectories-object.md | 6 +- .../objects/my-computer-info-object.md | 2 +- .../objects/my-computer-keyboard-object.md | 4 +- .../objects/my-computer-mouse-object.md | 4 +- .../objects/my-computer-network-object.md | 4 +- .../objects/my-computer-object.md | 22 +- .../objects/my-computer-ports-object.md | 4 +- .../objects/my-computer-registry-object.md | 4 +- .../objects/my-forms-object.md | 8 +- .../objects/my-log-object.md | 2 +- .../objects/my-request-object.md | 2 +- .../objects/my-resources-object.md | 4 +- .../objects/my-response-object.md | 2 +- .../objects/my-settings-object.md | 16 +- .../objects/my-user-object.md | 2 +- .../objects/my-webservices-object.md | 8 +- .../objects/textfieldparser-object.md | 2 +- .../operators/addition-assignment-operator.md | 22 +- .../operators/addition-operator.md | 26 +- .../operators/addressof-operator.md | 8 +- .../operators/and-assignment-operator.md | 18 +- .../operators/and-operator.md | 16 +- .../operators/andalso-operator.md | 16 +- .../operators/arithmetic-operators.md | 18 +- .../operators/assignment-operator.md | 28 +- .../operators/assignment-operators.md | 26 +- .../operators/await-operator.md | 14 +- .../operators/bit-shift-operators.md | 6 +- .../operators/comparison-operators.md | 26 +- .../operators/concatenation-operator.md | 16 +- .../operators/concatenation-operators.md | 8 +- .../data-types-of-operator-results.md | 50 +- .../operators/directcast-operator.md | 10 +- .../exponentiation-assignment-operator.md | 18 +- .../operators/exponentiation-operator.md | 14 +- ...ting-point-division-assignment-operator.md | 20 +- .../floating-point-division-operator.md | 28 +- .../operators/function-expression.md | 26 +- .../operators/gettype-operator.md | 6 +- .../operators/getxmlnamespace-operator.md | 6 +- .../operators/if-operator.md | 2 +- .../integer-division-assignment-operator.md | 20 +- .../operators/integer-division-operator.md | 24 +- .../operators/is-operator.md | 14 +- .../operators/isfalse-operator.md | 8 +- .../operators/istrue-operator.md | 8 +- .../left-shift-assignment-operator.md | 16 +- .../operators/left-shift-operator.md | 14 +- .../operators/like-operator.md | 18 +- .../operators/logical-bitwise-operators.md | 20 +- .../operators/miscellaneous-operators.md | 14 +- .../operators/mod-operator.md | 22 +- .../multiplication-assignment-operator.md | 16 +- .../operators/multiplication-operator.md | 22 +- .../operators/not-operator.md | 10 +- .../operators/null-conditional-operators.md | 4 +- .../operators/operator-precedence.md | 16 +- .../operators-listed-by-functionality.md | 18 +- .../operators/or-operator.md | 16 +- .../operators/orelse-operator.md | 16 +- .../right-shift-assignment-operator.md | 16 +- .../operators/right-shift-operator.md | 14 +- .../operators/sub-expression.md | 16 +- .../subtraction-assignment-operator.md | 16 +- .../operators/subtraction-operator.md | 16 +- .../operators/trycast-operator.md | 16 +- .../operators/typeof-operator.md | 12 +- .../operators/xor-operator.md | 14 +- .../language-reference/properties.md | 4 +- .../queries/aggregate-clause.md | 18 +- .../queries/distinct-clause.md | 10 +- .../queries/equals-clause.md | 6 +- .../language-reference/queries/from-clause.md | 34 +- .../queries/group-by-clause.md | 16 +- .../queries/group-join-clause.md | 18 +- .../language-reference/queries/index.md | 32 +- .../language-reference/queries/join-clause.md | 12 +- .../language-reference/queries/let-clause.md | 10 +- .../queries/order-by-clause.md | 8 +- .../queries/select-clause.md | 14 +- .../language-reference/queries/skip-clause.md | 16 +- .../queries/skip-while-clause.md | 14 +- .../language-reference/queries/take-clause.md | 16 +- .../queries/take-while-clause.md | 14 +- .../queries/where-clause.md | 14 +- .../runtime-library-members.md | 6 +- .../special-characters/index.md | 2 +- .../statements/addhandler-statement.md | 12 +- .../statements/alias-clause.md | 4 +- .../statements/as-clause.md | 50 +- .../statements/attribute-list.md | 12 +- .../statements/class-statement.md | 58 +- .../language-reference/statements/clauses.md | 16 +- .../statements/const-statement.md | 28 +- .../statements/continue-statement.md | 10 +- ...tion-contexts-and-default-access-levels.md | 38 +- .../statements/declare-statement.md | 38 +- .../statements/delegate-statement.md | 26 +- .../statements/do-loop-statement.md | 22 +- .../statements/else-statement.md | 8 +- .../statements/end-statement.md | 8 +- .../statements/enum-statement.md | 34 +- .../statements/erase-statement.md | 4 +- .../statements/error-statement.md | 8 +- .../statements/event-statement.md | 34 +- .../statements/f-p-statements.md | 18 +- .../statements/for-each-next-statement.md | 34 +- .../statements/for-next-statement.md | 28 +- .../statements/function-statement.md | 54 +- .../statements/get-statement.md | 24 +- .../statements/goto-statement.md | 20 +- .../statements/handles-clause.md | 16 +- .../statements/if-then-else-statement.md | 16 +- .../statements/implements-clause.md | 22 +- .../statements/implements-statement.md | 12 +- .../imports-statement-xml-namespace.md | 14 +- .../statements/in-clause.md | 10 +- .../language-reference/statements/index.md | 18 +- .../statements/inherits-statement.md | 10 +- .../statements/interface-statement.md | 50 +- .../statements/into-clause.md | 8 +- .../statements/mid-statement.md | 6 +- .../statements/module-statement.md | 40 +- .../statements/namespace-statement.md | 18 +- .../statements/of-clause.md | 24 +- .../statements/on-error-statement.md | 16 +- .../statements/operator-statement.md | 42 +- .../statements/option-compare-statement.md | 18 +- .../statements/option-explicit-statement.md | 18 +- .../statements/option-infer-statement.md | 22 +- .../statements/option-keyword-statement.md | 10 +- .../statements/option-strict-statement.md | 48 +- .../statements/parameter-list.md | 28 +- .../statements/q-z-statements.md | 16 +- .../statements/raiseevent-statement.md | 12 +- .../statements/redim-statement.md | 16 +- .../statements/rem-statement.md | 4 +- .../statements/removehandler-statement.md | 10 +- .../statements/resume-statement.md | 12 +- .../statements/return-statement.md | 16 +- .../statements/select-case-statement.md | 12 +- .../statements/set-statement.md | 22 +- .../statements/stop-statement.md | 2 +- .../statements/sub-statement.md | 22 +- .../statements/synclock-statement.md | 2 +- .../statements/then-statement.md | 6 +- .../statements/throw-statement.md | 4 +- .../statements/try-catch-finally-statement.md | 2 +- .../statements/type-list.md | 30 +- .../statements/while-end-while-statement.md | 26 +- .../statements/with-end-with-statement.md | 10 +- .../statements/yield-statement.md | 10 +- .../typographic-and-code-conventions.md | 14 +- .../xml-axis/extension-indexer-property.md | 10 +- .../language-reference/xml-axis/index.md | 12 +- .../xml-axis/xml-attribute-axis-property.md | 12 +- .../xml-axis/xml-child-axis-property.md | 14 +- .../xml-axis/xml-descendant-axis-property.md | 14 +- .../language-reference/xml-literals/index.md | 12 +- .../xml-literals/xml-cdata-literal.md | 6 +- .../xml-literals/xml-comment-literal.md | 6 +- .../xml-literals/xml-document-literal.md | 16 +- .../xml-literals/xml-element-literal.md | 28 +- .../xml-processing-instruction-literal.md | 8 +- .../language-reference/xmldoc/c.md | 6 +- .../language-reference/xmldoc/code.md | 6 +- .../language-reference/xmldoc/example.md | 6 +- .../language-reference/xmldoc/exception.md | 4 +- .../language-reference/xmldoc/include.md | 2 +- .../language-reference/xmldoc/index.md | 18 +- .../language-reference/xmldoc/list.md | 4 +- .../language-reference/xmldoc/para.md | 6 +- .../language-reference/xmldoc/param.md | 4 +- .../language-reference/xmldoc/paramref.md | 4 +- .../language-reference/xmldoc/permission.md | 4 +- .../language-reference/xmldoc/remarks.md | 6 +- .../language-reference/xmldoc/returns.md | 4 +- .../language-reference/xmldoc/see.md | 6 +- .../language-reference/xmldoc/seealso.md | 6 +- .../language-reference/xmldoc/summary.md | 6 +- .../language-reference/xmldoc/typeparam.md | 4 +- .../language-reference/xmldoc/value.md | 6 +- ...er-cannot-be-nothing-or-an-empty-string.md | 6 +- ...-created-with-this-name-on-this-machine.md | 12 +- ...add-failed-duplicate-key-value-supplied.md | 2 +- ...ress-is-not-a-valid-remote-file-address.md | 2 +- ...-last-element-must-be-greater-than-zero.md | 4 +- ...id-name-was-specified-for-the-event-log.md | 4 +- ...ication-defined-or-object-defined-error.md | 2 +- ...han-or-equal-to-the-length-of-argument2.md | 2 +- ...me-cannot-be-an-empty-string-or-nothing.md | 4 +- ...-cannot-be-converted-to-a-numeric-value.md | 2 +- ...ntname-cannot-be-converted-to-type-date.md | 4 +- ...me-cannot-be-converted-to-type-typename.md | 2 +- ...ument-argumentname-is-not-a-valid-value.md | 2 +- ...argumentname-is-not-valid-for-the-array.md | 4 +- ...gument-argumentname-is-nothing-or-empty.md | 4 +- .../misc/argument-argumentname-is-nothing.md | 2 +- ...me-must-be-greater-than-0-or-equal-to-1.md | 2 +- ...me-must-be-greater-than-or-equal-to-1-1.md | 2 +- ...name-must-be-greater-than-or-equal-to-1.md | 2 +- ...must-be-greater-than-or-equal-to-zero-1.md | 2 +- ...e-must-be-greater-than-or-equal-to-zero.md | 2 +- ...-argumentname-must-be-greater-than-zero.md | 2 +- ...-must-be-in-the-range-of-32768-to-65535.md | 2 +- ...ntname-must-be-within-the-range-0-to-99.md | 2 +- ...tname-must-be-within-the-range-1-to-255.md | 2 +- ...an-or-equal-the-length-of-argumentname2.md | 2 +- ...ent-basepath-must-be-a-path-to-a-folder.md | 2 +- .../argument-cannot-be-an-empty-string.md | 2 +- .../misc/argument-life-cannot-be-zero.md | 2 +- ...argument-nper-must-be-greater-than-zero.md | 2 +- .../misc/argument-path-is-nothing-or-empty.md | 4 +- .../misc/argument-per-is-not-valid.md | 2 +- ...-be-less-than-or-equal-to-argument-life.md | 2 +- ...cters-that-are-not-valid-in-a-path-name.md | 2 +- .../misc/arguments-are-not-valid.md | 2 +- ...specified-in-the-vbfixedarray-attribute.md | 2 +- ...on-object-does-not-have-a-default-value.md | 2 +- docs/visual-basic/misc/bad-record-number.md | 2 +- docs/visual-basic/misc/bc2000.md | 2 +- docs/visual-basic/misc/bc2001.md | 2 +- docs/visual-basic/misc/bc2003.md | 2 +- docs/visual-basic/misc/bc2006.md | 2 +- docs/visual-basic/misc/bc2009.md | 4 +- docs/visual-basic/misc/bc2011.md | 2 +- docs/visual-basic/misc/bc2015.md | 4 +- docs/visual-basic/misc/bc2020.md | 2 +- docs/visual-basic/misc/bc2023.md | 4 +- docs/visual-basic/misc/bc2025.md | 4 +- docs/visual-basic/misc/bc2027.md | 2 +- docs/visual-basic/misc/bc2028.md | 4 +- docs/visual-basic/misc/bc2030.md | 6 +- docs/visual-basic/misc/bc2033.md | 6 +- docs/visual-basic/misc/bc2034.md | 6 +- docs/visual-basic/misc/bc30003.md | 6 +- docs/visual-basic/misc/bc30004.md | 2 +- docs/visual-basic/misc/bc30012.md | 2 +- docs/visual-basic/misc/bc30013.md | 2 +- docs/visual-basic/misc/bc30015.md | 4 +- docs/visual-basic/misc/bc30016.md | 10 +- docs/visual-basic/misc/bc30018.md | 6 +- docs/visual-basic/misc/bc30019.md | 6 +- docs/visual-basic/misc/bc30021.md | 4 +- docs/visual-basic/misc/bc30022.md | 6 +- docs/visual-basic/misc/bc30023.md | 6 +- docs/visual-basic/misc/bc30025.md | 4 +- docs/visual-basic/misc/bc30026.md | 4 +- docs/visual-basic/misc/bc30027.md | 4 +- docs/visual-basic/misc/bc30028.md | 2 +- docs/visual-basic/misc/bc30030.md | 2 +- docs/visual-basic/misc/bc30032.md | 2 +- docs/visual-basic/misc/bc30034.md | 2 +- docs/visual-basic/misc/bc30037.md | 2 +- docs/visual-basic/misc/bc30038.md | 6 +- docs/visual-basic/misc/bc30039.md | 2 +- docs/visual-basic/misc/bc30040.md | 4 +- docs/visual-basic/misc/bc30041.md | 2 +- docs/visual-basic/misc/bc30044.md | 2 +- docs/visual-basic/misc/bc30046.md | 4 +- docs/visual-basic/misc/bc30049.md | 6 +- docs/visual-basic/misc/bc30050.md | 6 +- docs/visual-basic/misc/bc30051.md | 6 +- docs/visual-basic/misc/bc30052.md | 2 +- docs/visual-basic/misc/bc30053.md | 4 +- docs/visual-basic/misc/bc30057.md | 2 +- docs/visual-basic/misc/bc30058.md | 2 +- docs/visual-basic/misc/bc30059.md | 2 +- docs/visual-basic/misc/bc30060.md | 4 +- docs/visual-basic/misc/bc30062.md | 2 +- docs/visual-basic/misc/bc30064.md | 4 +- docs/visual-basic/misc/bc30065.md | 6 +- docs/visual-basic/misc/bc30066.md | 6 +- docs/visual-basic/misc/bc30067.md | 6 +- docs/visual-basic/misc/bc30069.md | 2 +- docs/visual-basic/misc/bc30070.md | 2 +- docs/visual-basic/misc/bc30071.md | 2 +- docs/visual-basic/misc/bc30072.md | 2 +- docs/visual-basic/misc/bc30074.md | 2 +- docs/visual-basic/misc/bc30075.md | 2 +- docs/visual-basic/misc/bc30081.md | 2 +- docs/visual-basic/misc/bc30082.md | 2 +- docs/visual-basic/misc/bc30083.md | 2 +- docs/visual-basic/misc/bc30084.md | 2 +- docs/visual-basic/misc/bc30085.md | 2 +- docs/visual-basic/misc/bc30086.md | 2 +- docs/visual-basic/misc/bc30087.md | 2 +- docs/visual-basic/misc/bc30088.md | 2 +- docs/visual-basic/misc/bc30089.md | 2 +- docs/visual-basic/misc/bc30090.md | 2 +- docs/visual-basic/misc/bc30091.md | 2 +- docs/visual-basic/misc/bc30092.md | 4 +- docs/visual-basic/misc/bc30093.md | 2 +- docs/visual-basic/misc/bc30094.md | 4 +- docs/visual-basic/misc/bc30095.md | 2 +- docs/visual-basic/misc/bc30096.md | 4 +- docs/visual-basic/misc/bc30097.md | 2 +- docs/visual-basic/misc/bc30098.md | 4 +- docs/visual-basic/misc/bc30099.md | 2 +- docs/visual-basic/misc/bc30101.md | 6 +- docs/visual-basic/misc/bc30103.md | 2 +- docs/visual-basic/misc/bc30105.md | 2 +- docs/visual-basic/misc/bc30107.md | 2 +- docs/visual-basic/misc/bc30109.md | 2 +- docs/visual-basic/misc/bc30110.md | 2 +- docs/visual-basic/misc/bc30111.md | 2 +- docs/visual-basic/misc/bc30112.md | 2 +- docs/visual-basic/misc/bc30113.md | 4 +- docs/visual-basic/misc/bc30114.md | 10 +- docs/visual-basic/misc/bc30121.md | 4 +- docs/visual-basic/misc/bc30124.md | 6 +- docs/visual-basic/misc/bc30125.md | 4 +- docs/visual-basic/misc/bc30126.md | 4 +- docs/visual-basic/misc/bc30132.md | 6 +- docs/visual-basic/misc/bc30134.md | 2 +- docs/visual-basic/misc/bc30135.md | 2 +- docs/visual-basic/misc/bc30166.md | 2 +- docs/visual-basic/misc/bc30176.md | 2 +- docs/visual-basic/misc/bc30178.md | 2 +- docs/visual-basic/misc/bc30180.md | 10 +- docs/visual-basic/misc/bc30181.md | 10 +- docs/visual-basic/misc/bc30182.md | 10 +- docs/visual-basic/misc/bc30183.md | 2 +- docs/visual-basic/misc/bc30184.md | 2 +- docs/visual-basic/misc/bc30185.md | 2 +- docs/visual-basic/misc/bc30186.md | 2 +- docs/visual-basic/misc/bc30192.md | 2 +- docs/visual-basic/misc/bc30195.md | 4 +- docs/visual-basic/misc/bc30196.md | 2 +- docs/visual-basic/misc/bc30197.md | 4 +- docs/visual-basic/misc/bc30198.md | 2 +- docs/visual-basic/misc/bc30199.md | 2 +- docs/visual-basic/misc/bc30200.md | 4 +- docs/visual-basic/misc/bc30201.md | 2 +- docs/visual-basic/misc/bc30204.md | 2 +- docs/visual-basic/misc/bc30206.md | 10 +- docs/visual-basic/misc/bc30207.md | 2 +- docs/visual-basic/misc/bc30208.md | 2 +- docs/visual-basic/misc/bc30209.md | 4 +- docs/visual-basic/misc/bc30210.md | 6 +- docs/visual-basic/misc/bc30211.md | 6 +- docs/visual-basic/misc/bc30213.md | 4 +- docs/visual-basic/misc/bc30215.md | 2 +- docs/visual-basic/misc/bc30217.md | 2 +- docs/visual-basic/misc/bc30218.md | 2 +- docs/visual-basic/misc/bc30224.md | 2 +- docs/visual-basic/misc/bc30225.md | 8 +- docs/visual-basic/misc/bc30230.md | 4 +- docs/visual-basic/misc/bc30231.md | 4 +- docs/visual-basic/misc/bc30232.md | 4 +- docs/visual-basic/misc/bc30233.md | 2 +- docs/visual-basic/misc/bc30234.md | 4 +- docs/visual-basic/misc/bc30235.md | 2 +- docs/visual-basic/misc/bc30237.md | 2 +- docs/visual-basic/misc/bc30238.md | 2 +- docs/visual-basic/misc/bc30239.md | 6 +- docs/visual-basic/misc/bc30240.md | 2 +- docs/visual-basic/misc/bc30241.md | 2 +- docs/visual-basic/misc/bc30242.md | 4 +- docs/visual-basic/misc/bc30243.md | 2 +- docs/visual-basic/misc/bc30244.md | 2 +- docs/visual-basic/misc/bc30246.md | 2 +- docs/visual-basic/misc/bc30247.md | 2 +- docs/visual-basic/misc/bc30248.md | 2 +- docs/visual-basic/misc/bc30249.md | 4 +- docs/visual-basic/misc/bc30252.md | 2 +- docs/visual-basic/misc/bc30253.md | 2 +- docs/visual-basic/misc/bc30256.md | 2 +- docs/visual-basic/misc/bc30257.md | 2 +- docs/visual-basic/misc/bc30258.md | 2 +- docs/visual-basic/misc/bc30266.md | 2 +- docs/visual-basic/misc/bc30270.md | 4 +- docs/visual-basic/misc/bc30272.md | 2 +- docs/visual-basic/misc/bc30273.md | 4 +- docs/visual-basic/misc/bc30274.md | 2 +- docs/visual-basic/misc/bc30275.md | 4 +- docs/visual-basic/misc/bc30277.md | 2 +- docs/visual-basic/misc/bc30278.md | 4 +- docs/visual-basic/misc/bc30280.md | 2 +- docs/visual-basic/misc/bc30281.md | 6 +- docs/visual-basic/misc/bc30287.md | 2 +- docs/visual-basic/misc/bc30288.md | 2 +- docs/visual-basic/misc/bc30289.md | 2 +- docs/visual-basic/misc/bc30290.md | 2 +- docs/visual-basic/misc/bc30293.md | 2 +- docs/visual-basic/misc/bc30294.md | 4 +- docs/visual-basic/misc/bc30296.md | 4 +- docs/visual-basic/misc/bc30299.md | 6 +- docs/visual-basic/misc/bc30300.md | 4 +- docs/visual-basic/misc/bc30301.md | 4 +- docs/visual-basic/misc/bc30302.md | 2 +- docs/visual-basic/misc/bc30303.md | 4 +- docs/visual-basic/misc/bc30305.md | 4 +- docs/visual-basic/misc/bc30308.md | 2 +- docs/visual-basic/misc/bc30311.md | 4 +- docs/visual-basic/misc/bc30321.md | 2 +- docs/visual-basic/misc/bc30332.md | 4 +- docs/visual-basic/misc/bc30333.md | 4 +- docs/visual-basic/misc/bc30337.md | 4 +- docs/visual-basic/misc/bc30345.md | 4 +- docs/visual-basic/misc/bc30354.md | 4 +- docs/visual-basic/misc/bc30357.md | 2 +- docs/visual-basic/misc/bc30359.md | 2 +- docs/visual-basic/misc/bc30360.md | 2 +- docs/visual-basic/misc/bc30361.md | 4 +- docs/visual-basic/misc/bc30362.md | 2 +- docs/visual-basic/misc/bc30366.md | 2 +- docs/visual-basic/misc/bc30367.md | 2 +- docs/visual-basic/misc/bc30368.md | 4 +- docs/visual-basic/misc/bc30370.md | 8 +- docs/visual-basic/misc/bc30371.md | 2 +- docs/visual-basic/misc/bc30375.md | 8 +- docs/visual-basic/misc/bc30376.md | 2 +- docs/visual-basic/misc/bc30379.md | 2 +- docs/visual-basic/misc/bc30380.md | 2 +- docs/visual-basic/misc/bc30381.md | 2 +- docs/visual-basic/misc/bc30382.md | 2 +- docs/visual-basic/misc/bc30383.md | 2 +- docs/visual-basic/misc/bc30384.md | 2 +- docs/visual-basic/misc/bc30385.md | 4 +- docs/visual-basic/misc/bc30387.md | 10 +- docs/visual-basic/misc/bc30389.md | 2 +- docs/visual-basic/misc/bc30390.md | 6 +- docs/visual-basic/misc/bc30392.md | 2 +- docs/visual-basic/misc/bc30393.md | 2 +- docs/visual-basic/misc/bc30395.md | 2 +- docs/visual-basic/misc/bc30396.md | 2 +- docs/visual-basic/misc/bc30398.md | 2 +- docs/visual-basic/misc/bc30399.md | 2 +- docs/visual-basic/misc/bc30408.md | 2 +- docs/visual-basic/misc/bc30412.md | 2 +- docs/visual-basic/misc/bc30413.md | 4 +- docs/visual-basic/misc/bc30414.md | 2 +- docs/visual-basic/misc/bc30415.md | 4 +- docs/visual-basic/misc/bc30423.md | 4 +- docs/visual-basic/misc/bc30429.md | 4 +- docs/visual-basic/misc/bc30430.md | 4 +- docs/visual-basic/misc/bc30431.md | 2 +- docs/visual-basic/misc/bc30433.md | 2 +- docs/visual-basic/misc/bc30434.md | 2 +- docs/visual-basic/misc/bc30435.md | 4 +- docs/visual-basic/misc/bc30436.md | 2 +- docs/visual-basic/misc/bc30438.md | 2 +- docs/visual-basic/misc/bc30441.md | 2 +- docs/visual-basic/misc/bc30442.md | 2 +- docs/visual-basic/misc/bc30443.md | 2 +- docs/visual-basic/misc/bc30444.md | 2 +- docs/visual-basic/misc/bc30445.md | 2 +- docs/visual-basic/misc/bc30452.md | 6 +- docs/visual-basic/misc/bc30455.md | 4 +- docs/visual-basic/misc/bc30458.md | 2 +- docs/visual-basic/misc/bc30460.md | 2 +- docs/visual-basic/misc/bc30461.md | 4 +- docs/visual-basic/misc/bc30465.md | 2 +- docs/visual-basic/misc/bc30467.md | 4 +- docs/visual-basic/misc/bc30468.md | 2 +- docs/visual-basic/misc/bc30469.md | 2 +- docs/visual-basic/misc/bc30471.md | 2 +- docs/visual-basic/misc/bc30474.md | 2 +- docs/visual-basic/misc/bc30476.md | 2 +- docs/visual-basic/misc/bc30479.md | 2 +- docs/visual-basic/misc/bc30480.md | 4 +- docs/visual-basic/misc/bc30487.md | 6 +- docs/visual-basic/misc/bc30490.md | 2 +- docs/visual-basic/misc/bc30493.md | 2 +- docs/visual-basic/misc/bc30495.md | 2 +- docs/visual-basic/misc/bc30497.md | 6 +- docs/visual-basic/misc/bc30501.md | 8 +- docs/visual-basic/misc/bc30502.md | 2 +- docs/visual-basic/misc/bc30503.md | 4 +- docs/visual-basic/misc/bc30504.md | 2 +- docs/visual-basic/misc/bc30505.md | 2 +- docs/visual-basic/misc/bc30512.md | 26 +- docs/visual-basic/misc/bc30516.md | 2 +- docs/visual-basic/misc/bc30517.md | 2 +- docs/visual-basic/misc/bc30518.md | 2 +- docs/visual-basic/misc/bc30519.md | 6 +- docs/visual-basic/misc/bc30520.md | 6 +- docs/visual-basic/misc/bc30521.md | 20 +- docs/visual-basic/misc/bc30524.md | 2 +- docs/visual-basic/misc/bc30526.md | 2 +- docs/visual-basic/misc/bc30532.md | 2 +- docs/visual-basic/misc/bc30533.md | 2 +- docs/visual-basic/misc/bc30542.md | 2 +- docs/visual-basic/misc/bc30544.md | 2 +- docs/visual-basic/misc/bc30545.md | 4 +- docs/visual-basic/misc/bc30547.md | 2 +- docs/visual-basic/misc/bc30550.md | 2 +- docs/visual-basic/misc/bc30554.md | 4 +- docs/visual-basic/misc/bc30555.md | 2 +- docs/visual-basic/misc/bc30562.md | 4 +- docs/visual-basic/misc/bc30563.md | 2 +- docs/visual-basic/misc/bc30569.md | 4 +- docs/visual-basic/misc/bc30572.md | 4 +- docs/visual-basic/misc/bc30573.md | 4 +- docs/visual-basic/misc/bc30574.md | 6 +- docs/visual-basic/misc/bc30576.md | 2 +- docs/visual-basic/misc/bc30578.md | 2 +- docs/visual-basic/misc/bc30579.md | 2 +- docs/visual-basic/misc/bc30580.md | 2 +- docs/visual-basic/misc/bc30581.md | 2 +- docs/visual-basic/misc/bc30582.md | 2 +- docs/visual-basic/misc/bc30584.md | 2 +- docs/visual-basic/misc/bc30587.md | 4 +- docs/visual-basic/misc/bc30588.md | 2 +- docs/visual-basic/misc/bc30593.md | 2 +- docs/visual-basic/misc/bc30601.md | 2 +- docs/visual-basic/misc/bc30603.md | 4 +- docs/visual-basic/misc/bc30604.md | 4 +- docs/visual-basic/misc/bc30607.md | 6 +- docs/visual-basic/misc/bc30610.md | 4 +- docs/visual-basic/misc/bc30611.md | 2 +- docs/visual-basic/misc/bc30614.md | 6 +- docs/visual-basic/misc/bc30615.md | 2 +- docs/visual-basic/misc/bc30618.md | 4 +- docs/visual-basic/misc/bc30619.md | 2 +- docs/visual-basic/misc/bc30620.md | 8 +- docs/visual-basic/misc/bc30621.md | 4 +- docs/visual-basic/misc/bc30622.md | 2 +- docs/visual-basic/misc/bc30623.md | 4 +- docs/visual-basic/misc/bc30624.md | 4 +- docs/visual-basic/misc/bc30625.md | 2 +- docs/visual-basic/misc/bc30626.md | 4 +- docs/visual-basic/misc/bc30627.md | 10 +- docs/visual-basic/misc/bc30628.md | 4 +- docs/visual-basic/misc/bc30629.md | 4 +- docs/visual-basic/misc/bc30630.md | 2 +- docs/visual-basic/misc/bc30631.md | 2 +- docs/visual-basic/misc/bc30632.md | 2 +- docs/visual-basic/misc/bc30633.md | 2 +- docs/visual-basic/misc/bc30634.md | 2 +- docs/visual-basic/misc/bc30635.md | 4 +- docs/visual-basic/misc/bc30636.md | 2 +- docs/visual-basic/misc/bc30639.md | 2 +- docs/visual-basic/misc/bc30640.md | 2 +- docs/visual-basic/misc/bc30641.md | 4 +- docs/visual-basic/misc/bc30642.md | 4 +- docs/visual-basic/misc/bc30643.md | 2 +- docs/visual-basic/misc/bc30647.md | 8 +- docs/visual-basic/misc/bc30649.md | 2 +- docs/visual-basic/misc/bc30650.md | 4 +- docs/visual-basic/misc/bc30651.md | 4 +- docs/visual-basic/misc/bc30654.md | 4 +- docs/visual-basic/misc/bc30656.md | 2 +- docs/visual-basic/misc/bc30657.md | 2 +- docs/visual-basic/misc/bc30658.md | 2 +- docs/visual-basic/misc/bc30661.md | 2 +- docs/visual-basic/misc/bc30664.md | 2 +- docs/visual-basic/misc/bc30665.md | 4 +- docs/visual-basic/misc/bc30666.md | 4 +- docs/visual-basic/misc/bc30667.md | 6 +- docs/visual-basic/misc/bc30670.md | 2 +- docs/visual-basic/misc/bc30671.md | 4 +- docs/visual-basic/misc/bc30672.md | 2 +- docs/visual-basic/misc/bc30674.md | 2 +- docs/visual-basic/misc/bc30675.md | 2 +- docs/visual-basic/misc/bc30676.md | 4 +- docs/visual-basic/misc/bc30677.md | 6 +- docs/visual-basic/misc/bc30678.md | 4 +- docs/visual-basic/misc/bc30679.md | 6 +- docs/visual-basic/misc/bc30680.md | 2 +- docs/visual-basic/misc/bc30681.md | 2 +- docs/visual-basic/misc/bc30683.md | 2 +- docs/visual-basic/misc/bc30688.md | 2 +- docs/visual-basic/misc/bc30689.md | 2 +- docs/visual-basic/misc/bc30690.md | 2 +- docs/visual-basic/misc/bc30691.md | 4 +- docs/visual-basic/misc/bc30695.md | 2 +- docs/visual-basic/misc/bc30696.md | 2 +- docs/visual-basic/misc/bc30697.md | 2 +- docs/visual-basic/misc/bc30700.md | 2 +- docs/visual-basic/misc/bc30701.md | 2 +- docs/visual-basic/misc/bc30702.md | 2 +- docs/visual-basic/misc/bc30705.md | 2 +- docs/visual-basic/misc/bc30706.md | 2 +- docs/visual-basic/misc/bc30713.md | 4 +- docs/visual-basic/misc/bc30715.md | 2 +- docs/visual-basic/misc/bc30716.md | 2 +- docs/visual-basic/misc/bc30717.md | 2 +- docs/visual-basic/misc/bc30718.md | 2 +- docs/visual-basic/misc/bc30724.md | 2 +- docs/visual-basic/misc/bc30725.md | 2 +- docs/visual-basic/misc/bc30726.md | 2 +- docs/visual-basic/misc/bc30728.md | 4 +- docs/visual-basic/misc/bc30730.md | 4 +- docs/visual-basic/misc/bc30731.md | 2 +- docs/visual-basic/misc/bc30734.md | 2 +- docs/visual-basic/misc/bc30735.md | 4 +- docs/visual-basic/misc/bc30736.md | 2 +- docs/visual-basic/misc/bc30738.md | 2 +- docs/visual-basic/misc/bc30739.md | 2 +- docs/visual-basic/misc/bc30741.md | 2 +- docs/visual-basic/misc/bc30742.md | 2 +- docs/visual-basic/misc/bc30744.md | 2 +- docs/visual-basic/misc/bc30748.md | 2 +- docs/visual-basic/misc/bc30752.md | 2 +- docs/visual-basic/misc/bc30753.md | 10 +- docs/visual-basic/misc/bc30754.md | 2 +- docs/visual-basic/misc/bc30755.md | 2 +- docs/visual-basic/misc/bc30756.md | 2 +- docs/visual-basic/misc/bc30757.md | 2 +- docs/visual-basic/misc/bc30758.md | 2 +- docs/visual-basic/misc/bc30759.md | 2 +- docs/visual-basic/misc/bc30760.md | 2 +- docs/visual-basic/misc/bc30762.md | 2 +- docs/visual-basic/misc/bc30763.md | 6 +- docs/visual-basic/misc/bc30764.md | 2 +- docs/visual-basic/misc/bc30767.md | 4 +- docs/visual-basic/misc/bc30768.md | 2 +- docs/visual-basic/misc/bc30769.md | 2 +- docs/visual-basic/misc/bc30770.md | 6 +- docs/visual-basic/misc/bc30780.md | 2 +- docs/visual-basic/misc/bc30781.md | 2 +- docs/visual-basic/misc/bc30782.md | 4 +- docs/visual-basic/misc/bc30783.md | 4 +- docs/visual-basic/misc/bc30784.md | 4 +- docs/visual-basic/misc/bc30785.md | 2 +- docs/visual-basic/misc/bc30786.md | 4 +- docs/visual-basic/misc/bc30791.md | 4 +- docs/visual-basic/misc/bc30792.md | 10 +- docs/visual-basic/misc/bc30793.md | 18 +- docs/visual-basic/misc/bc30794.md | 10 +- docs/visual-basic/misc/bc30795.md | 6 +- docs/visual-basic/misc/bc30796.md | 2 +- docs/visual-basic/misc/bc30798.md | 4 +- docs/visual-basic/misc/bc30800.md | 2 +- docs/visual-basic/misc/bc30802.md | 4 +- docs/visual-basic/misc/bc30803.md | 2 +- docs/visual-basic/misc/bc30804.md | 2 +- docs/visual-basic/misc/bc30805.md | 4 +- docs/visual-basic/misc/bc30807.md | 2 +- docs/visual-basic/misc/bc30808.md | 2 +- docs/visual-basic/misc/bc30809.md | 4 +- docs/visual-basic/misc/bc30810.md | 2 +- docs/visual-basic/misc/bc30811.md | 4 +- docs/visual-basic/misc/bc30814.md | 2 +- docs/visual-basic/misc/bc30815.md | 2 +- docs/visual-basic/misc/bc30817.md | 6 +- docs/visual-basic/misc/bc30818.md | 2 +- docs/visual-basic/misc/bc30822.md | 4 +- docs/visual-basic/misc/bc30823.md | 6 +- docs/visual-basic/misc/bc30826.md | 2 +- docs/visual-basic/misc/bc30827.md | 4 +- docs/visual-basic/misc/bc30829.md | 4 +- docs/visual-basic/misc/bc30906.md | 6 +- docs/visual-basic/misc/bc30907.md | 2 +- docs/visual-basic/misc/bc30908.md | 4 +- docs/visual-basic/misc/bc30911.md | 2 +- docs/visual-basic/misc/bc30912.md | 2 +- docs/visual-basic/misc/bc30916.md | 2 +- docs/visual-basic/misc/bc30921.md | 10 +- docs/visual-basic/misc/bc30922.md | 10 +- docs/visual-basic/misc/bc30925.md | 10 +- docs/visual-basic/misc/bc30926.md | 8 +- docs/visual-basic/misc/bc30927.md | 10 +- docs/visual-basic/misc/bc30928.md | 8 +- docs/visual-basic/misc/bc30931.md | 12 +- docs/visual-basic/misc/bc30932.md | 4 +- docs/visual-basic/misc/bc30934.md | 4 +- docs/visual-basic/misc/bc30935.md | 4 +- docs/visual-basic/misc/bc30937.md | 4 +- docs/visual-basic/misc/bc30939.md | 4 +- docs/visual-basic/misc/bc30940.md | 6 +- docs/visual-basic/misc/bc30943.md | 4 +- docs/visual-basic/misc/bc30944.md | 10 +- docs/visual-basic/misc/bc30945.md | 2 +- docs/visual-basic/misc/bc30949.md | 4 +- docs/visual-basic/misc/bc30950.md | 10 +- docs/visual-basic/misc/bc30951.md | 8 +- docs/visual-basic/misc/bc30952.md | 8 +- docs/visual-basic/misc/bc30954.md | 8 +- docs/visual-basic/misc/bc30975.md | 2 +- docs/visual-basic/misc/bc30976.md | 2 +- docs/visual-basic/misc/bc30978.md | 4 +- docs/visual-basic/misc/bc30979.md | 10 +- docs/visual-basic/misc/bc30980.md | 10 +- docs/visual-basic/misc/bc30981.md | 4 +- docs/visual-basic/misc/bc30983.md | 10 +- docs/visual-basic/misc/bc30984.md | 2 +- docs/visual-basic/misc/bc30985.md | 2 +- docs/visual-basic/misc/bc30987.md | 4 +- docs/visual-basic/misc/bc30988.md | 6 +- docs/visual-basic/misc/bc30989.md | 2 +- docs/visual-basic/misc/bc30990.md | 4 +- docs/visual-basic/misc/bc30991.md | 6 +- docs/visual-basic/misc/bc30992.md | 2 +- docs/visual-basic/misc/bc30993.md | 8 +- docs/visual-basic/misc/bc30994.md | 4 +- docs/visual-basic/misc/bc30995.md | 4 +- docs/visual-basic/misc/bc30999.md | 2 +- docs/visual-basic/misc/bc31014.md | 2 +- docs/visual-basic/misc/bc31029.md | 2 +- docs/visual-basic/misc/bc31033.md | 4 +- docs/visual-basic/misc/bc31035.md | 6 +- docs/visual-basic/misc/bc31040.md | 4 +- docs/visual-basic/misc/bc31041.md | 4 +- docs/visual-basic/misc/bc31042.md | 4 +- docs/visual-basic/misc/bc31044.md | 8 +- docs/visual-basic/misc/bc31047.md | 4 +- docs/visual-basic/misc/bc31049.md | 4 +- docs/visual-basic/misc/bc31051.md | 2 +- docs/visual-basic/misc/bc31052.md | 2 +- docs/visual-basic/misc/bc31053.md | 4 +- docs/visual-basic/misc/bc31059.md | 2 +- docs/visual-basic/misc/bc31060.md | 2 +- docs/visual-basic/misc/bc31061.md | 2 +- docs/visual-basic/misc/bc31063.md | 2 +- docs/visual-basic/misc/bc31064.md | 2 +- docs/visual-basic/misc/bc31065.md | 2 +- docs/visual-basic/misc/bc31067.md | 6 +- docs/visual-basic/misc/bc31068.md | 2 +- docs/visual-basic/misc/bc31069.md | 4 +- docs/visual-basic/misc/bc31070.md | 4 +- docs/visual-basic/misc/bc31071.md | 4 +- docs/visual-basic/misc/bc31072.md | 2 +- docs/visual-basic/misc/bc31073.md | 2 +- docs/visual-basic/misc/bc31076.md | 4 +- docs/visual-basic/misc/bc31077.md | 4 +- docs/visual-basic/misc/bc31080.md | 6 +- docs/visual-basic/misc/bc31082.md | 2 +- docs/visual-basic/misc/bc31083.md | 8 +- docs/visual-basic/misc/bc31085.md | 4 +- docs/visual-basic/misc/bc31086.md | 6 +- docs/visual-basic/misc/bc31087.md | 2 +- docs/visual-basic/misc/bc31088.md | 8 +- docs/visual-basic/misc/bc31089.md | 2 +- docs/visual-basic/misc/bc31091.md | 4 +- docs/visual-basic/misc/bc31092.md | 2 +- docs/visual-basic/misc/bc31094.md | 4 +- docs/visual-basic/misc/bc31095.md | 2 +- docs/visual-basic/misc/bc31096.md | 2 +- docs/visual-basic/misc/bc31099.md | 6 +- docs/visual-basic/misc/bc31100.md | 8 +- docs/visual-basic/misc/bc31101.md | 6 +- docs/visual-basic/misc/bc31104.md | 6 +- docs/visual-basic/misc/bc31105.md | 6 +- docs/visual-basic/misc/bc31106.md | 16 +- docs/visual-basic/misc/bc31107.md | 10 +- docs/visual-basic/misc/bc31108.md | 10 +- docs/visual-basic/misc/bc31109.md | 4 +- docs/visual-basic/misc/bc31110.md | 4 +- docs/visual-basic/misc/bc31111.md | 6 +- docs/visual-basic/misc/bc31112.md | 2 +- docs/visual-basic/misc/bc31113.md | 4 +- docs/visual-basic/misc/bc31114.md | 2 +- docs/visual-basic/misc/bc31115.md | 4 +- docs/visual-basic/misc/bc31116.md | 4 +- docs/visual-basic/misc/bc31117.md | 4 +- docs/visual-basic/misc/bc31118.md | 6 +- docs/visual-basic/misc/bc31119.md | 6 +- docs/visual-basic/misc/bc31120.md | 6 +- docs/visual-basic/misc/bc31121.md | 10 +- docs/visual-basic/misc/bc31123.md | 2 +- docs/visual-basic/misc/bc31124.md | 4 +- docs/visual-basic/misc/bc31125.md | 4 +- docs/visual-basic/misc/bc31126.md | 4 +- docs/visual-basic/misc/bc31127.md | 4 +- docs/visual-basic/misc/bc31128.md | 4 +- docs/visual-basic/misc/bc31129.md | 4 +- docs/visual-basic/misc/bc31130.md | 4 +- docs/visual-basic/misc/bc31131.md | 4 +- docs/visual-basic/misc/bc31132.md | 4 +- docs/visual-basic/misc/bc31133.md | 4 +- docs/visual-basic/misc/bc31134.md | 6 +- docs/visual-basic/misc/bc31135.md | 4 +- docs/visual-basic/misc/bc31136.md | 4 +- docs/visual-basic/misc/bc31137.md | 6 +- docs/visual-basic/misc/bc31138.md | 8 +- docs/visual-basic/misc/bc31140.md | 4 +- docs/visual-basic/misc/bc31141.md | 8 +- docs/visual-basic/misc/bc31142.md | 8 +- docs/visual-basic/misc/bc31143.md | 2 +- docs/visual-basic/misc/bc31146.md | 4 +- docs/visual-basic/misc/bc31148.md | 6 +- docs/visual-basic/misc/bc31149.md | 4 +- docs/visual-basic/misc/bc31150.md | 4 +- docs/visual-basic/misc/bc31151.md | 4 +- docs/visual-basic/misc/bc31152.md | 4 +- docs/visual-basic/misc/bc31153.md | 8 +- docs/visual-basic/misc/bc31154.md | 6 +- docs/visual-basic/misc/bc31155.md | 6 +- docs/visual-basic/misc/bc31156.md | 8 +- docs/visual-basic/misc/bc31157.md | 8 +- docs/visual-basic/misc/bc31159.md | 6 +- docs/visual-basic/misc/bc31160.md | 6 +- docs/visual-basic/misc/bc31161.md | 6 +- docs/visual-basic/misc/bc31162.md | 6 +- docs/visual-basic/misc/bc31163.md | 4 +- docs/visual-basic/misc/bc31164.md | 4 +- docs/visual-basic/misc/bc31165.md | 4 +- docs/visual-basic/misc/bc31166.md | 4 +- docs/visual-basic/misc/bc31167.md | 4 +- docs/visual-basic/misc/bc31169.md | 6 +- docs/visual-basic/misc/bc31170.md | 6 +- docs/visual-basic/misc/bc31171.md | 6 +- docs/visual-basic/misc/bc31172.md | 6 +- docs/visual-basic/misc/bc31173.md | 4 +- docs/visual-basic/misc/bc31174.md | 6 +- docs/visual-basic/misc/bc31175.md | 4 +- docs/visual-basic/misc/bc31176.md | 4 +- docs/visual-basic/misc/bc31177.md | 4 +- docs/visual-basic/misc/bc31178.md | 6 +- docs/visual-basic/misc/bc31179.md | 6 +- docs/visual-basic/misc/bc31181.md | 6 +- docs/visual-basic/misc/bc31182.md | 6 +- docs/visual-basic/misc/bc31184.md | 6 +- docs/visual-basic/misc/bc31186.md | 4 +- docs/visual-basic/misc/bc31187.md | 6 +- docs/visual-basic/misc/bc31189.md | 6 +- docs/visual-basic/misc/bc31190.md | 6 +- docs/visual-basic/misc/bc31191.md | 4 +- docs/visual-basic/misc/bc31192.md | 4 +- docs/visual-basic/misc/bc31193.md | 8 +- docs/visual-basic/misc/bc31195.md | 4 +- docs/visual-basic/misc/bc31196.md | 6 +- docs/visual-basic/misc/bc31197.md | 4 +- docs/visual-basic/misc/bc31198.md | 6 +- docs/visual-basic/misc/bc31199.md | 2 +- docs/visual-basic/misc/bc31394.md | 2 +- docs/visual-basic/misc/bc31395.md | 8 +- docs/visual-basic/misc/bc31398.md | 8 +- docs/visual-basic/misc/bc31399.md | 10 +- docs/visual-basic/misc/bc31400.md | 2 +- docs/visual-basic/misc/bc31401.md | 2 +- docs/visual-basic/misc/bc31403.md | 2 +- docs/visual-basic/misc/bc31404.md | 2 +- docs/visual-basic/misc/bc31405.md | 4 +- docs/visual-basic/misc/bc31406.md | 4 +- docs/visual-basic/misc/bc31407.md | 2 +- docs/visual-basic/misc/bc31408.md | 4 +- docs/visual-basic/misc/bc31409.md | 2 +- docs/visual-basic/misc/bc31410.md | 4 +- docs/visual-basic/misc/bc31411.md | 4 +- docs/visual-basic/misc/bc31412.md | 6 +- docs/visual-basic/misc/bc31413.md | 4 +- docs/visual-basic/misc/bc31415.md | 2 +- docs/visual-basic/misc/bc31416.md | 6 +- docs/visual-basic/misc/bc31417.md | 4 +- docs/visual-basic/misc/bc31418.md | 6 +- docs/visual-basic/misc/bc31419.md | 6 +- docs/visual-basic/misc/bc31420.md | 4 +- docs/visual-basic/misc/bc31422.md | 4 +- docs/visual-basic/misc/bc31426.md | 4 +- docs/visual-basic/misc/bc31429.md | 4 +- docs/visual-basic/misc/bc31430.md | 4 +- docs/visual-basic/misc/bc31431.md | 2 +- docs/visual-basic/misc/bc31432.md | 2 +- docs/visual-basic/misc/bc31433.md | 2 +- docs/visual-basic/misc/bc31434.md | 2 +- docs/visual-basic/misc/bc31435.md | 2 +- docs/visual-basic/misc/bc31437.md | 4 +- docs/visual-basic/misc/bc31438.md | 6 +- docs/visual-basic/misc/bc31439.md | 2 +- docs/visual-basic/misc/bc31440.md | 4 +- docs/visual-basic/misc/bc31441.md | 4 +- docs/visual-basic/misc/bc31442.md | 2 +- docs/visual-basic/misc/bc31443.md | 4 +- docs/visual-basic/misc/bc31500.md | 2 +- docs/visual-basic/misc/bc31501.md | 2 +- docs/visual-basic/misc/bc31502.md | 4 +- docs/visual-basic/misc/bc31509.md | 4 +- docs/visual-basic/misc/bc31510.md | 2 +- docs/visual-basic/misc/bc31511.md | 2 +- docs/visual-basic/misc/bc31516.md | 2 +- docs/visual-basic/misc/bc31517.md | 2 +- docs/visual-basic/misc/bc31522.md | 2 +- docs/visual-basic/misc/bc31523.md | 2 +- docs/visual-basic/misc/bc31524.md | 2 +- docs/visual-basic/misc/bc31526.md | 2 +- docs/visual-basic/misc/bc31527.md | 4 +- docs/visual-basic/misc/bc31529.md | 2 +- docs/visual-basic/misc/bc31530.md | 2 +- docs/visual-basic/misc/bc31531.md | 2 +- docs/visual-basic/misc/bc31536.md | 2 +- docs/visual-basic/misc/bc31538.md | 8 +- docs/visual-basic/misc/bc32000.md | 2 +- docs/visual-basic/misc/bc32002.md | 2 +- docs/visual-basic/misc/bc32004.md | 2 +- docs/visual-basic/misc/bc32006.md | 2 +- docs/visual-basic/misc/bc32007.md | 4 +- docs/visual-basic/misc/bc32009.md | 6 +- docs/visual-basic/misc/bc32013.md | 6 +- docs/visual-basic/misc/bc32014.md | 2 +- docs/visual-basic/misc/bc32015.md | 4 +- docs/visual-basic/misc/bc32016.md | 8 +- docs/visual-basic/misc/bc32017.md | 4 +- docs/visual-basic/misc/bc32019.md | 6 +- docs/visual-basic/misc/bc32020.md | 4 +- docs/visual-basic/misc/bc32021.md | 2 +- docs/visual-basic/misc/bc32023.md | 4 +- docs/visual-basic/misc/bc32024.md | 4 +- docs/visual-basic/misc/bc32026.md | 4 +- docs/visual-basic/misc/bc32027.md | 2 +- docs/visual-basic/misc/bc32028.md | 4 +- docs/visual-basic/misc/bc32029.md | 8 +- docs/visual-basic/misc/bc32030.md | 2 +- docs/visual-basic/misc/bc32031.md | 4 +- docs/visual-basic/misc/bc32032.md | 4 +- docs/visual-basic/misc/bc32033.md | 4 +- docs/visual-basic/misc/bc32034.md | 4 +- docs/visual-basic/misc/bc32035.md | 2 +- docs/visual-basic/misc/bc32036.md | 10 +- docs/visual-basic/misc/bc32037.md | 2 +- docs/visual-basic/misc/bc32038.md | 2 +- docs/visual-basic/misc/bc32040.md | 2 +- docs/visual-basic/misc/bc32041.md | 10 +- docs/visual-basic/misc/bc32042.md | 6 +- docs/visual-basic/misc/bc32043.md | 4 +- docs/visual-basic/misc/bc32044.md | 4 +- docs/visual-basic/misc/bc32045.md | 8 +- docs/visual-basic/misc/bc32046.md | 6 +- docs/visual-basic/misc/bc32047.md | 2 +- docs/visual-basic/misc/bc32048.md | 4 +- docs/visual-basic/misc/bc32049.md | 4 +- docs/visual-basic/misc/bc32050.md | 8 +- docs/visual-basic/misc/bc32052.md | 12 +- docs/visual-basic/misc/bc32054.md | 4 +- docs/visual-basic/misc/bc32055.md | 6 +- docs/visual-basic/misc/bc32056.md | 6 +- docs/visual-basic/misc/bc32058.md | 10 +- docs/visual-basic/misc/bc32059.md | 2 +- docs/visual-basic/misc/bc32060.md | 4 +- docs/visual-basic/misc/bc32065.md | 4 +- docs/visual-basic/misc/bc32066.md | 4 +- docs/visual-basic/misc/bc32067.md | 2 +- docs/visual-basic/misc/bc32068.md | 6 +- docs/visual-basic/misc/bc32070.md | 6 +- docs/visual-basic/misc/bc32071.md | 4 +- docs/visual-basic/misc/bc32072.md | 8 +- docs/visual-basic/misc/bc32073.md | 10 +- docs/visual-basic/misc/bc32074.md | 6 +- docs/visual-basic/misc/bc32075.md | 4 +- docs/visual-basic/misc/bc32076.md | 6 +- docs/visual-basic/misc/bc32077.md | 4 +- docs/visual-basic/misc/bc32078.md | 4 +- docs/visual-basic/misc/bc32079.md | 4 +- docs/visual-basic/misc/bc32080.md | 8 +- docs/visual-basic/misc/bc32081.md | 4 +- docs/visual-basic/misc/bc32082.md | 6 +- docs/visual-basic/misc/bc32083.md | 8 +- docs/visual-basic/misc/bc32084.md | 10 +- docs/visual-basic/misc/bc32085.md | 6 +- docs/visual-basic/misc/bc32086.md | 4 +- docs/visual-basic/misc/bc32087.md | 12 +- docs/visual-basic/misc/bc32088.md | 8 +- docs/visual-basic/misc/bc32089.md | 4 +- docs/visual-basic/misc/bc32090.md | 4 +- docs/visual-basic/misc/bc32092.md | 10 +- docs/visual-basic/misc/bc32093.md | 6 +- docs/visual-basic/misc/bc32094.md | 4 +- docs/visual-basic/misc/bc32095.md | 2 +- docs/visual-basic/misc/bc32097.md | 12 +- docs/visual-basic/misc/bc32099.md | 4 +- docs/visual-basic/misc/bc32100.md | 4 +- docs/visual-basic/misc/bc32101.md | 8 +- docs/visual-basic/misc/bc32102.md | 8 +- docs/visual-basic/misc/bc32103.md | 8 +- docs/visual-basic/misc/bc32104.md | 6 +- docs/visual-basic/misc/bc32105.md | 10 +- docs/visual-basic/misc/bc32106.md | 10 +- docs/visual-basic/misc/bc32107.md | 6 +- docs/visual-basic/misc/bc32108.md | 6 +- docs/visual-basic/misc/bc32109.md | 10 +- docs/visual-basic/misc/bc32110.md | 10 +- docs/visual-basic/misc/bc32111.md | 10 +- docs/visual-basic/misc/bc32113.md | 4 +- docs/visual-basic/misc/bc32114.md | 8 +- docs/visual-basic/misc/bc32115.md | 4 +- docs/visual-basic/misc/bc32116.md | 6 +- docs/visual-basic/misc/bc32117.md | 10 +- docs/visual-basic/misc/bc32118.md | 10 +- docs/visual-basic/misc/bc32119.md | 10 +- docs/visual-basic/misc/bc32120.md | 8 +- docs/visual-basic/misc/bc32121.md | 8 +- docs/visual-basic/misc/bc32122.md | 8 +- docs/visual-basic/misc/bc32123.md | 8 +- docs/visual-basic/misc/bc32125.md | 8 +- docs/visual-basic/misc/bc32127.md | 4 +- docs/visual-basic/misc/bc32129.md | 4 +- docs/visual-basic/misc/bc32130.md | 2 +- docs/visual-basic/misc/bc32200.md | 4 +- docs/visual-basic/misc/bc32201.md | 4 +- docs/visual-basic/misc/bc32203.md | 4 +- docs/visual-basic/misc/bc32204.md | 4 +- docs/visual-basic/misc/bc32205.md | 4 +- docs/visual-basic/misc/bc32303.md | 8 +- docs/visual-basic/misc/bc32304.md | 6 +- docs/visual-basic/misc/bc32504.md | 2 +- docs/visual-basic/misc/bc32508.md | 4 +- docs/visual-basic/misc/bc32509.md | 4 +- docs/visual-basic/misc/bc32510.md | 4 +- docs/visual-basic/misc/bc33001.md | 10 +- docs/visual-basic/misc/bc33002.md | 10 +- docs/visual-basic/misc/bc33003.md | 12 +- docs/visual-basic/misc/bc33004.md | 10 +- docs/visual-basic/misc/bc33005.md | 10 +- docs/visual-basic/misc/bc33006.md | 8 +- docs/visual-basic/misc/bc33007.md | 10 +- docs/visual-basic/misc/bc33008.md | 10 +- docs/visual-basic/misc/bc33009.md | 10 +- docs/visual-basic/misc/bc33010.md | 10 +- docs/visual-basic/misc/bc33011.md | 12 +- docs/visual-basic/misc/bc33012.md | 12 +- docs/visual-basic/misc/bc33013.md | 8 +- docs/visual-basic/misc/bc33014.md | 10 +- docs/visual-basic/misc/bc33015.md | 10 +- docs/visual-basic/misc/bc33016.md | 10 +- docs/visual-basic/misc/bc33017.md | 12 +- docs/visual-basic/misc/bc33018.md | 10 +- docs/visual-basic/misc/bc33019.md | 16 +- docs/visual-basic/misc/bc33020.md | 8 +- docs/visual-basic/misc/bc33021.md | 8 +- docs/visual-basic/misc/bc33022.md | 8 +- docs/visual-basic/misc/bc33023.md | 14 +- docs/visual-basic/misc/bc33024.md | 10 +- docs/visual-basic/misc/bc33025.md | 8 +- docs/visual-basic/misc/bc33026.md | 8 +- docs/visual-basic/misc/bc33027.md | 8 +- docs/visual-basic/misc/bc33028.md | 10 +- docs/visual-basic/misc/bc33029.md | 8 +- docs/visual-basic/misc/bc33030.md | 8 +- docs/visual-basic/misc/bc33031.md | 8 +- docs/visual-basic/misc/bc33032.md | 10 +- docs/visual-basic/misc/bc33033.md | 12 +- docs/visual-basic/misc/bc33034.md | 16 +- docs/visual-basic/misc/bc33035.md | 16 +- docs/visual-basic/misc/bc33037.md | 18 +- docs/visual-basic/misc/bc33038.md | 12 +- docs/visual-basic/misc/bc33039.md | 10 +- docs/visual-basic/misc/bc33040.md | 10 +- docs/visual-basic/misc/bc33041.md | 10 +- docs/visual-basic/misc/bc33100.md | 2 +- docs/visual-basic/misc/bc33101.md | 2 +- docs/visual-basic/misc/bc33102.md | 2 +- docs/visual-basic/misc/bc33104.md | 4 +- docs/visual-basic/misc/bc33105.md | 4 +- docs/visual-basic/misc/bc33106.md | 6 +- docs/visual-basic/misc/bc33109.md | 2 +- docs/visual-basic/misc/bc33110.md | 6 +- docs/visual-basic/misc/bc33111.md | 6 +- docs/visual-basic/misc/bc33112.md | 2 +- docs/visual-basic/misc/bc36001.md | 6 +- docs/visual-basic/misc/bc36002.md | 4 +- docs/visual-basic/misc/bc36005.md | 4 +- docs/visual-basic/misc/bc36006.md | 4 +- docs/visual-basic/misc/bc36007.md | 4 +- docs/visual-basic/misc/bc36008.md | 4 +- docs/visual-basic/misc/bc36009.md | 4 +- docs/visual-basic/misc/bc36010.md | 4 +- docs/visual-basic/misc/bc36011.md | 6 +- docs/visual-basic/misc/bc36012.md | 4 +- docs/visual-basic/misc/bc36013.md | 4 +- docs/visual-basic/misc/bc36533.md | 6 +- docs/visual-basic/misc/bc36535.md | 6 +- docs/visual-basic/misc/bc36547.md | 4 +- docs/visual-basic/misc/bc36549.md | 4 +- docs/visual-basic/misc/bc36551.md | 6 +- docs/visual-basic/misc/bc36552.md | 6 +- docs/visual-basic/misc/bc36553.md | 6 +- docs/visual-basic/misc/bc36554.md | 6 +- docs/visual-basic/misc/bc36557.md | 4 +- docs/visual-basic/misc/bc36558.md | 2 +- docs/visual-basic/misc/bc36559.md | 4 +- docs/visual-basic/misc/bc36560.md | 6 +- docs/visual-basic/misc/bc36561.md | 4 +- docs/visual-basic/misc/bc36565.md | 2 +- docs/visual-basic/misc/bc36566.md | 2 +- docs/visual-basic/misc/bc36567.md | 2 +- docs/visual-basic/misc/bc36568.md | 2 +- docs/visual-basic/misc/bc36569.md | 2 +- docs/visual-basic/misc/bc36572.md | 8 +- docs/visual-basic/misc/bc36574.md | 2 +- docs/visual-basic/misc/bc36575.md | 2 +- docs/visual-basic/misc/bc36576.md | 4 +- docs/visual-basic/misc/bc36577.md | 2 +- docs/visual-basic/misc/bc36578.md | 6 +- docs/visual-basic/misc/bc36579.md | 4 +- docs/visual-basic/misc/bc36580.md | 6 +- docs/visual-basic/misc/bc36581.md | 10 +- docs/visual-basic/misc/bc36582.md | 4 +- docs/visual-basic/misc/bc36583.md | 4 +- docs/visual-basic/misc/bc36584.md | 4 +- docs/visual-basic/misc/bc36585.md | 4 +- docs/visual-basic/misc/bc36586.md | 4 +- docs/visual-basic/misc/bc36589.md | 10 +- docs/visual-basic/misc/bc36590.md | 8 +- docs/visual-basic/misc/bc36591.md | 6 +- docs/visual-basic/misc/bc36594.md | 12 +- docs/visual-basic/misc/bc36595.md | 8 +- docs/visual-basic/misc/bc36597.md | 4 +- docs/visual-basic/misc/bc36598.md | 4 +- docs/visual-basic/misc/bc36600.md | 10 +- docs/visual-basic/misc/bc36601.md | 10 +- docs/visual-basic/misc/bc36602.md | 4 +- docs/visual-basic/misc/bc36604.md | 2 +- docs/visual-basic/misc/bc36605.md | 10 +- docs/visual-basic/misc/bc36606.md | 8 +- docs/visual-basic/misc/bc36607.md | 8 +- docs/visual-basic/misc/bc36609.md | 4 +- docs/visual-basic/misc/bc36610.md | 8 +- docs/visual-basic/misc/bc36613.md | 10 +- docs/visual-basic/misc/bc36614.md | 10 +- docs/visual-basic/misc/bc36615.md | 10 +- docs/visual-basic/misc/bc36617.md | 12 +- docs/visual-basic/misc/bc36618.md | 10 +- docs/visual-basic/misc/bc36619.md | 10 +- docs/visual-basic/misc/bc36620.md | 10 +- docs/visual-basic/misc/bc36621.md | 12 +- docs/visual-basic/misc/bc36622.md | 12 +- docs/visual-basic/misc/bc36625.md | 2 +- docs/visual-basic/misc/bc36626.md | 4 +- docs/visual-basic/misc/bc36627.md | 2 +- docs/visual-basic/misc/bc36628.md | 2 +- docs/visual-basic/misc/bc36631.md | 8 +- docs/visual-basic/misc/bc36632.md | 2 +- docs/visual-basic/misc/bc36634.md | 2 +- docs/visual-basic/misc/bc36636.md | 6 +- docs/visual-basic/misc/bc36637.md | 2 +- docs/visual-basic/misc/bc36638.md | 4 +- docs/visual-basic/misc/bc36639.md | 2 +- docs/visual-basic/misc/bc36640.md | 2 +- docs/visual-basic/misc/bc36641.md | 6 +- docs/visual-basic/misc/bc36642.md | 2 +- docs/visual-basic/misc/bc36643.md | 2 +- docs/visual-basic/misc/bc36648-bc36645.md | 4 +- docs/visual-basic/misc/bc36649-bc36646.md | 8 +- docs/visual-basic/misc/bc36650-bc36653.md | 6 +- docs/visual-basic/misc/bc36651-bc36654.md | 4 +- docs/visual-basic/misc/bc36655-bc36652.md | 6 +- docs/visual-basic/misc/bc36659-bc36656.md | 8 +- docs/visual-basic/misc/bc36660-bc36657.md | 8 +- docs/visual-basic/misc/bc36661-bc36658.md | 12 +- docs/visual-basic/misc/bc36662.md | 8 +- docs/visual-basic/misc/bc36663.md | 6 +- docs/visual-basic/misc/bc36664.md | 2 +- docs/visual-basic/misc/bc36666-bc36665.md | 2 +- docs/visual-basic/misc/bc36707.md | 6 +- docs/visual-basic/misc/bc36708.md | 10 +- docs/visual-basic/misc/bc36709.md | 8 +- docs/visual-basic/misc/bc36710.md | 4 +- docs/visual-basic/misc/bc36711.md | 6 +- docs/visual-basic/misc/bc36714.md | 6 +- docs/visual-basic/misc/bc36807.md | 8 +- docs/visual-basic/misc/bc36808.md | 8 +- docs/visual-basic/misc/bc36809.md | 8 +- docs/visual-basic/misc/bc36907.md | 4 +- docs/visual-basic/misc/bc36909.md | 2 +- docs/visual-basic/misc/bc40003.md | 16 +- docs/visual-basic/misc/bc40004.md | 4 +- docs/visual-basic/misc/bc40005.md | 6 +- docs/visual-basic/misc/bc40011.md | 2 +- docs/visual-basic/misc/bc40012.md | 6 +- docs/visual-basic/misc/bc40014.md | 8 +- docs/visual-basic/misc/bc40018.md | 6 +- docs/visual-basic/misc/bc40019.md | 2 +- docs/visual-basic/misc/bc40020.md | 2 +- docs/visual-basic/misc/bc40021.md | 14 +- docs/visual-basic/misc/bc40022.md | 8 +- docs/visual-basic/misc/bc40023.md | 6 +- docs/visual-basic/misc/bc40024.md | 8 +- docs/visual-basic/misc/bc40034.md | 2 +- docs/visual-basic/misc/bc40038.md | 12 +- docs/visual-basic/misc/bc40040.md | 10 +- docs/visual-basic/misc/bc40043.md | 6 +- docs/visual-basic/misc/bc40046.md | 6 +- docs/visual-basic/misc/bc40047.md | 4 +- docs/visual-basic/misc/bc40048.md | 4 +- docs/visual-basic/misc/bc40049.md | 4 +- docs/visual-basic/misc/bc40050.md | 2 +- docs/visual-basic/misc/bc40051.md | 8 +- docs/visual-basic/misc/bc40052.md | 6 +- docs/visual-basic/misc/bc40053.md | 4 +- docs/visual-basic/misc/bc40055.md | 10 +- docs/visual-basic/misc/bc41005.md | 6 +- docs/visual-basic/misc/bc41006.md | 8 +- docs/visual-basic/misc/bc41007.md | 2 +- docs/visual-basic/misc/bc41008.md | 10 +- docs/visual-basic/misc/bc41998.md | 8 +- docs/visual-basic/misc/bc42000.md | 4 +- docs/visual-basic/misc/bc42003.md | 2 +- docs/visual-basic/misc/bc42004.md | 8 +- docs/visual-basic/misc/bc42014.md | 4 +- docs/visual-basic/misc/bc42016.md | 4 +- docs/visual-basic/misc/bc42018.md | 12 +- docs/visual-basic/misc/bc42019.md | 6 +- docs/visual-basic/misc/bc42020.md | 6 +- docs/visual-basic/misc/bc42021.md | 4 +- docs/visual-basic/misc/bc42022.md | 8 +- docs/visual-basic/misc/bc42024.md | 4 +- docs/visual-basic/misc/bc42028.md | 22 +- docs/visual-basic/misc/bc42029.md | 2 +- docs/visual-basic/misc/bc42030.md | 16 +- docs/visual-basic/misc/bc42031.md | 2 +- docs/visual-basic/misc/bc42032.md | 12 +- docs/visual-basic/misc/bc42034.md | 2 +- docs/visual-basic/misc/bc42035.md | 2 +- docs/visual-basic/misc/bc42036.md | 8 +- docs/visual-basic/misc/bc42099.md | 4 +- docs/visual-basic/misc/bc42102.md | 6 +- docs/visual-basic/misc/bc42106.md | 8 +- docs/visual-basic/misc/bc42108.md | 20 +- docs/visual-basic/misc/bc42109.md | 2 +- docs/visual-basic/misc/bc42111.md | 8 +- docs/visual-basic/misc/bc42206.md | 2 +- docs/visual-basic/misc/bc42207.md | 4 +- docs/visual-basic/misc/bc42300.md | 4 +- docs/visual-basic/misc/bc42301.md | 4 +- docs/visual-basic/misc/bc42302.md | 4 +- docs/visual-basic/misc/bc42303.md | 4 +- docs/visual-basic/misc/bc42304.md | 16 +- docs/visual-basic/misc/bc42305.md | 4 +- docs/visual-basic/misc/bc42306.md | 4 +- docs/visual-basic/misc/bc42307.md | 4 +- docs/visual-basic/misc/bc42308.md | 4 +- docs/visual-basic/misc/bc42309.md | 4 +- docs/visual-basic/misc/bc42310.md | 4 +- docs/visual-basic/misc/bc42311.md | 18 +- docs/visual-basic/misc/bc42312.md | 4 +- docs/visual-basic/misc/bc42313.md | 8 +- docs/visual-basic/misc/bc42314.md | 4 +- docs/visual-basic/misc/bc42315.md | 8 +- docs/visual-basic/misc/bc42316.md | 6 +- docs/visual-basic/misc/bc42317.md | 4 +- docs/visual-basic/misc/bc42318.md | 4 +- docs/visual-basic/misc/bc42320.md | 2 +- docs/visual-basic/misc/bc42321.md | 2 +- docs/visual-basic/misc/bc42328.md | 2 +- ...ulate-rate-using-the-arguments-provided.md | 2 +- ...which-is-not-instance-of-defining-class.md | 2 +- ...rgumentname-of-type-type1-to-type-type2.md | 2 +- ...nd-step-value-of-type2-to-a-common-type.md | 2 +- ...ot-convert-start-value-to-a-common-type.md | 2 +- .../misc/cannot-delete-a-registry-hive.md | 2 +- ...ermine-array-type-because-it-is-nothing.md | 4 +- .../misc/cannot-save-file-to-temp.md | 2 +- .../misc/cant-perform-requested-operation.md | 2 +- ...ng-string-to-type-typename-is-not-valid.md | 2 +- ...ypename1-to-type-typename2-is-not-valid.md | 2 +- .../class-not-registered-on-local-machine.md | 2 +- .../misc/code-resource-lock-error.md | 2 +- .../misc/code-resource-not-found.md | 2 +- ...ibrary-for-remote-process-has-been-lost.md | 2 +- ...get-directory-is-under-source-directory.md | 2 +- ...ation-system-name-due-to-internal-error.md | 2 +- ...emory-information-due-to-internal-error.md | 2 +- docs/visual-basic/misc/device-unavailable.md | 2 +- docs/visual-basic/misc/disk-full.md | 2 +- docs/visual-basic/misc/disk-not-ready.md | 2 +- .../misc/division-by-zero-error.md | 2 +- .../misc/division-by-zero-run-time-error.md | 2 +- .../misc/drive-drivename-not-found.md | 2 +- .../misc/encoding-cannot-be-set-to-nothing.md | 6 +- ...ccurs-as-the-target-of-a-procedure-call.md | 2 +- .../misc/feature-not-yet-implemented.md | 2 +- ...-fieldname-of-type-typename-is-readonly.md | 2 +- docs/visual-basic/misc/file-already-exists.md | 2 +- .../misc/file-filename-is-write-protected.md | 2 +- .../misc/file-format-not-valid.md | 2 +- ...t-be-queried-if-the-file-does-not-exist.md | 2 +- ...fieldname-of-type-typename-is-not-valid.md | 2 +- ...s-open-mode-wasn-t-set-to-a-valid-value.md | 4 +- ...-the-encoding-specified-by-fileencoding.md | 4 +- ...ied-in-filename-is-not-a-valid-xml-file.md | 2 +- .../misc/for-loop-not-initialized.md | 4 +- .../misc/format-not-valid-in-resource-file.md | 2 +- ...r-in-the-microsoft-visual-basic-runtime.md | 2 +- docs/visual-basic/misc/internal-error.md | 2 +- .../misc/invalid-pattern-string.md | 2 +- ...annot-be-deleted-because-it-has-subkeys.md | 2 +- ...eld-of-value-type-typename-is-not-valid.md | 2 +- ...-argumentname-must-be-greater-than-zero.md | 2 +- ...-be-parsed-using-the-current-delimiters.md | 6 +- ...be-parsed-using-the-current-fieldwidths.md | 6 +- ...ecause-it-exceeds-the-maximum-line-size.md | 4 +- ...a-com-class-cannot-be-called-late-bound.md | 2 +- ...-cannot-be-called-with-number-arguments.md | 2 +- ...me-has-no-parameter-named-parametername.md | 2 +- .../misc/method-or-data-member-not-found.md | 2 +- ...t-argumentname-specified-multiple-times.md | 2 +- .../misc/named-argument-not-found.md | 2 +- ...ents-cannot-match-paramarray-parameters.md | 6 +- ...n-be-called-with-these-arguments-list-2.md | 4 +- ...can-be-called-with-these-arguments-list.md | 2 +- ...name-can-be-called-with-these-arguments.md | 4 +- ...thodname-can-be-called-without-widening.md | 4 +- ...-default-member-found-for-type-typename.md | 4 +- ...argument-of-type-typename-for-parameter.md | 2 +- docs/visual-basic/misc/no-mouse-is-present.md | 2 +- ...numberofchars-must-be-greater-than-zero.md | 6 +- ...-doesn-t-support-current-locale-setting.md | 2 +- .../object-doesn-t-support-named-arguments.md | 2 +- .../object-doesn-t-support-this-action.md | 2 +- ...doesn-t-support-this-property-or-method.md | 2 +- docs/visual-basic/misc/off.md | 8 +- docs/visual-basic/misc/on.md | 14 +- ...folders-in-the-target-path-do-not-exist.md | 2 +- ...erator-is-not-valid-for-name1-and-name2.md | 2 +- ...operator-is-not-valid-for-type-typename.md | 2 +- .../misc/out-of-memory-run-time-error.md | 2 +- .../misc/path-pathname-not-found.md | 2 +- docs/visual-basic/misc/printer-error.md | 2 +- ...ot-be-set-to-an-empty-string-or-nothing.md | 4 +- ...y-propertyname-cannot-be-set-to-nothing.md | 4 +- .../misc/property-value-is-not-valid.md | 2 +- ...r-membername-on-type-typename-not-found.md | 4 +- ...an-only-change-the-right-most-dimension.md | 4 +- ...-cannot-change-the-number-of-dimensions.md | 4 +- ...edim-preserve-operand-cannot-be-nothing.md | 4 +- ...gistry-key-keyname-could-not-be-created.md | 2 +- ...registry-key-keyname-could-not-be-found.md | 2 +- .../misc/root-folder-cannot-be-renamed.md | 2 +- docs/visual-basic/misc/run-time-messages.md | 538 +++++++++--------- ...-caused-exceptions-during-the-operation.md | 2 +- ...ve-specifics-on-this-visual-basic-error.md | 6 +- ...e-folder-and-target-folder-are-the-same.md | 6 +- .../misc/specified-dll-function-not-found.md | 2 +- ...vent-log-does-not-exist-on-this-machine.md | 2 +- .../specified-registry-key-is-not-valid.md | 2 +- .../misc/stop-statement-encountered.md | 4 +- ...of-32767-characters-for-filesystem-apis.md | 2 +- .../misc/target-folder-is-a-file.md | 4 +- ...etfilepath-specifies-an-existing-folder.md | 4 +- ...-comment-tokens-that-contain-whitespace.md | 4 +- ...imiters-that-contain-endline-characters.md | 4 +- ...-uploadfile-needs-to-include-a-filename.md | 2 +- ...onnectiontimeout-must-be-greater-than-0.md | 4 +- .../misc/the-file-is-currently-closed.md | 2 +- .../the-file-is-currently-open-for-reading.md | 4 +- .../the-file-is-currently-open-for-writing.md | 4 +- ...-file-already-exists-with-the-same-path.md | 4 +- ...ds-with-a-directory-separator-character.md | 6 +- .../misc/the-path-has-not-been-set.md | 4 +- ...achine-does-not-exist-or-is-unavailable.md | 2 +- .../misc/the-source-folder-does-not-exist.md | 6 +- .../misc/the-specified-path-does-not-exist.md | 4 +- ...assed-to-textfieldparser-cannot-be-read.md | 8 +- .../misc/too-many-dll-application-clients.md | 2 +- ...ntname-is-typename-which-is-not-numeric.md | 2 +- ...-because-delimiters-is-nothing-or-empty.md | 6 +- .../misc/unable-to-read-delimited-fields.md | 4 +- ...because-fieldwidths-is-nothing-or-empty.md | 4 +- .../misc/unable-to-sink-events-of-object.md | 2 +- .../misc/user-interrupt-occurred.md | 2 +- ...uments-or-property-assignment-not-valid.md | 2 +- .../misc/you-must-specify-a-file-name.md | 4 +- .../misc/you-must-specify-a-name.md | 2 +- ...he-current-folder-or-one-of-sub-folders.md | 2 +- ...erability-in-net-framework-applications.md | 2 +- ...dows-function-that-takes-unsigned-types.md | 12 +- .../com-interop/how-to-call-windows-apis.md | 4 +- .../how-to-reference-com-objects.md | 10 +- .../how-to-work-with-activex-controls.md | 4 +- .../programming-guide/com-interop/index.md | 20 +- .../introduction-to-com-interop.md | 6 +- .../troubleshooting-interoperability.md | 6 +- .../walkthrough-calling-windows-apis.md | 8 +- .../walkthrough-creating-com-objects.md | 14 +- ...plementing-inheritance-with-com-objects.md | 8 +- .../concepts/async/async-return-types.md | 18 +- ...cancel-an-async-task-or-a-list-of-tasks.md | 6 +- ...ncel-async-tasks-after-a-period-of-time.md | 12 +- ...ining-async-tasks-after-one-is-complete.md | 6 +- .../async/control-flow-in-async-programs.md | 10 +- .../fine-tuning-your-async-application.md | 14 +- .../handling-reentrancy-in-async-apps.md | 6 +- ...async-walkthrough-by-using-task-whenall.md | 16 +- ...ts-in-parallel-by-using-async-and-await.md | 12 +- .../programming-guide/concepts/async/index.md | 24 +- ...tasks-and-process-them-as-they-complete.md | 6 +- .../async/using-async-for-file-access.md | 12 +- ...essing-the-web-by-using-async-and-await.md | 16 +- ...ccessing-attributes-by-using-reflection.md | 8 +- .../concepts/attributes/attributeusage.md | 12 +- .../concepts/attributes/common-attributes.md | 10 +- .../attributes/creating-custom-attributes.md | 10 +- ...reate-a-c-cpp-union-by-using-attributes.md | 10 +- .../concepts/attributes/index.md | 22 +- .../concepts/caller-information.md | 8 +- .../programming-guide/concepts/collections.md | 30 +- .../creating-variant-generic-interfaces.md | 8 +- .../covariance-contravariance/index.md | 18 +- ...e-for-func-and-action-generic-delegates.md | 4 +- .../using-variance-in-delegates.md | 4 +- ...e-in-interfaces-for-generic-collections.md | 4 +- .../variance-in-delegates.md | 8 +- .../variance-in-generic-interfaces.md | 8 +- ...gging-expression-trees-in-visual-studio.md | 2 +- .../how-to-execute-expression-trees.md | 4 +- .../how-to-modify-expression-trees.md | 4 +- ...pression-trees-to-build-dynamic-queries.md | 4 +- .../concepts/expression-trees/index.md | 16 +- .../programming-guide/concepts/index.md | 22 +- .../programming-guide/concepts/iterators.md | 20 +- ...nts-attributes-and-nodes-to-an-xml-tree.md | 2 +- .../linq/advanced-linq-to-xml-programming.md | 22 +- .../advanced-query-techniques-linq-to-xml.md | 18 +- .../concepts/linq/aggregation-operations.md | 14 +- ...licability-of-functional-transformation.md | 10 +- ...name-and-xnamespace-objects-linq-to-xml.md | 2 +- .../linq/basic-queries-linq-to-xml.md | 28 +- .../concepts/linq/basic-query-operations.md | 34 +- ...-query-operators-by-manner-of-execution.md | 6 +- .../concepts/linq/cloning-vs-attaching.md | 2 +- .../concepts/linq/concatenation-operations.md | 4 +- ...d-terminology-functional-transformation.md | 16 +- .../concepts/linq/converting-data-types.md | 6 +- ...ing-the-source-office-open-xml-document.md | 2 +- .../concepts/linq/creating-xml-trees.md | 16 +- ...tion-and-lazy-evaluation-in-linq-to-xml.md | 8 +- .../linq/deferred-execution-example.md | 2 +- ...ice-open-xml-wordprocessingml-documents.md | 8 +- .../concepts/linq/element-operations.md | 4 +- ...nabling-a-data-source-for-linq-querying.md | 4 +- .../concepts/linq/equality-operations.md | 4 +- ...-outputs-office-open-xml-document-parts.md | 2 +- .../linq/features-that-support-linq.md | 24 +- .../concepts/linq/filtering-data.md | 12 +- .../linq/finding-text-in-word-documents.md | 12 +- .../finding-the-default-paragraph-style.md | 6 +- .../functional-construction-linq-to-xml.md | 2 +- ...l-programming-vs-imperative-programming.md | 4 +- .../linq/functional-transformation-of-xml.md | 10 +- ...l-vs-procedural-programming-linq-to-xml.md | 6 +- .../concepts/linq/generation-operations.md | 2 +- .../linq/getting-started-linq-to-xml.md | 14 +- .../linq/getting-started-with-linq.md | 22 +- .../concepts/linq/grouping-data.md | 8 +- ...-to-add-custom-methods-for-linq-queries.md | 6 +- .../how-to-calculate-intermediate-values.md | 6 +- .../linq/how-to-catch-parsing-errors.md | 2 +- ...-to-chain-axis-method-calls-linq-to-xml.md | 6 +- ...ge-the-namespace-for-an-entire-xml-tree.md | 2 +- ...ine-and-compare-string-collections-linq.md | 4 +- ...ompare-the-contents-of-two-folders-linq.md | 4 +- ...e-column-values-in-a-csv-text-file-linq.md | 4 +- ...how-to-control-the-type-of-a-projection.md | 4 +- ...-occurrences-of-a-word-in-a-string-linq.md | 2 +- ...ow-to-create-a-document-with-namespaces.md | 2 +- .../linq/how-to-create-a-list-of-items.md | 14 +- .../how-to-create-a-tree-from-an-xmlreader.md | 4 +- .../how-to-create-hierarchy-using-grouping.md | 4 +- .../how-to-debug-empty-query-results-sets.md | 2 +- ...ilter-on-an-attribute-xpath-linq-to-xml.md | 4 +- .../how-to-filter-on-an-optional-element.md | 12 +- ...-to-filter-on-element-names-linq-to-xml.md | 6 +- ...-find-a-child-element-xpath-linq-to-xml.md | 4 +- ...ist-of-child-elements-xpath-linq-to-xml.md | 4 +- ...descendant-using-the-descendants-method.md | 2 +- ...ind-a-union-of-two-location-paths-xpath.md | 4 +- .../how-to-find-all-nodes-in-a-namespace.md | 4 +- ...tribute-of-the-parent-xpath-linq-to-xml.md | 4 +- ...nd-an-element-with-a-specific-attribute.md | 12 +- ...n-element-with-a-specific-child-element.md | 12 +- ...ibutes-of-siblings-with-a-specific-name.md | 4 +- ...o-find-child-elements-based-on-position.md | 4 +- ...d-descendant-elements-xpath-linq-to-xml.md | 4 +- ...ts-of-a-child-element-xpath-linq-to-xml.md | 2 +- ...escendants-with-a-specific-element-name.md | 2 +- .../how-to-find-elements-in-a-namespace.md | 2 +- ...find-elements-with-a-specific-attribute.md | 2 +- ...nd-preceding-siblings-xpath-linq-to-xml.md | 4 +- ...find-related-elements-xpath-linq-to-xml.md | 4 +- ...to-find-sibling-nodes-xpath-linq-to-xml.md | 4 +- ...ate-preceding-sibling-xpath-linq-to-xml.md | 2 +- ...find-the-root-element-xpath-linq-to-xml.md | 4 +- ...e-set-difference-between-two-lists-linq.md | 4 +- .../how-to-generate-text-files-from-xml.md | 4 +- .../how-to-generate-xml-from-csv-files.md | 2 +- .../how-to-group-files-by-extension-linq.md | 4 +- ...join-content-from-dissimilar-files-linq.md | 4 +- ...how-to-join-two-collections-linq-to-xml.md | 14 +- .../linq/how-to-list-all-nodes-in-a-tree.md | 2 +- .../linq/how-to-load-xml-from-a-file.md | 4 +- ...w-to-modify-an-office-open-xml-document.md | 4 +- .../concepts/linq/how-to-parse-a-string.md | 2 +- ...eaming-transform-of-large-xml-documents.md | 8 +- ...pulate-an-xml-tree-from-the-file-system.md | 2 +- ...-xml-tree-with-an-xmlwriter-linq-to-xml.md | 2 +- ...-collections-from-multiple-sources-linq.md | 6 +- .../how-to-project-a-new-type-linq-to-xml.md | 6 +- .../linq/how-to-project-an-anonymous-type.md | 6 +- .../linq/how-to-project-an-object-graph.md | 4 +- .../how-to-query-an-arraylist-with-linq.md | 6 +- ...ssembly-s-metadata-with-reflection-linq.md | 4 +- ...uplicate-files-in-a-directory-tree-linq.md | 4 +- ...iles-with-a-specified-attribute-or-name.md | 4 +- ...s-that-contain-a-specified-set-of-words.md | 2 +- ...rgest-file-or-files-in-a-directory-tree.md | 4 +- ...tal-number-of-bytes-in-a-set-of-folders.md | 4 +- .../how-to-query-linq-to-xml-using-xpath.md | 2 +- ...w-to-read-and-write-an-encoded-document.md | 2 +- ...-reorder-the-fields-of-a-delimited-file.md | 6 +- ...-a-collection-of-attributes-linq-to-xml.md | 2 +- ...ve-a-collection-of-elements-linq-to-xml.md | 4 +- ...retrieve-a-single-attribute-linq-to-xml.md | 2 +- ...ieve-a-single-child-element-linq-to-xml.md | 6 +- ...graphs-from-an-office-open-xml-document.md | 6 +- ...etrieve-the-shallow-value-of-an-element.md | 2 +- ...e-the-value-of-an-attribute-linq-to-xml.md | 4 +- ...eve-the-value-of-an-element-linq-to-xml.md | 2 +- ...-serialize-using-datacontractserializer.md | 2 +- .../how-to-serialize-using-xmlserializer.md | 2 +- .../how-to-sort-elements-on-multiple-keys.md | 6 +- .../concepts/linq/how-to-sort-elements.md | 8 +- ...ter-text-data-by-any-word-or-field-linq.md | 4 +- ...le-into-many-files-by-using-groups-linq.md | 4 +- ...-stream-xml-fragments-from-an-xmlreader.md | 8 +- ...ments-with-access-to-header-information.md | 4 +- ...w-to-transform-the-shape-of-an-xml-tree.md | 8 +- ...form-linq-to-xml-trees-in-an-xslt-style.md | 2 +- .../how-to-validate-using-xsd-linq-to-xml.md | 8 +- ...ork-with-dictionaries-using-linq-to-xml.md | 2 +- .../how-to-write-a-linq-to-xml-axis-method.md | 4 +- ...ry-that-finds-elements-based-on-context.md | 2 +- ...to-write-queries-with-complex-filtering.md | 18 +- ...modification-vs-functional-construction.md | 2 +- .../programming-guide/concepts/linq/index.md | 16 +- .../concepts/linq/introduction-to-linq.md | 8 +- ...tion-to-pure-functional-transformations.md | 12 +- .../linq/introduction-to-xml-literals.md | 6 +- .../concepts/linq/join-operations.md | 10 +- .../concepts/linq/language-integrated-axes.md | 10 +- .../linq/linq-and-file-directories.md | 14 +- .../concepts/linq/linq-and-reflection.md | 4 +- .../linq/linq-to-adonet-portal-page.md | 2 +- .../concepts/linq/linq-to-objects.md | 14 +- .../concepts/linq/linq-to-xml-annotations.md | 2 +- .../linq/linq-to-xml-axes-overview.md | 4 +- .../concepts/linq/linq-to-xml-axes.md | 24 +- .../linq/linq-to-xml-classes-overview.md | 10 +- .../concepts/linq/linq-to-xml-events.md | 2 +- .../linq/linq-to-xml-for-xpath-users.md | 34 +- .../concepts/linq/linq-to-xml-overview.md | 10 +- .../linq/linq-to-xml-programming-overview.md | 14 +- .../concepts/linq/linq-to-xml-security.md | 2 +- .../concepts/linq/linq-to-xml-vs-dom.md | 10 +- .../linq-to-xml-vs-other-xml-technologies.md | 4 +- .../concepts/linq/linq-to-xml.md | 12 +- .../linq/maintaining-name-value-pairs.md | 2 +- ...e-code-imperative-code-bugs-linq-to-xml.md | 4 +- ...nts-attributes-and-nodes-in-an-xml-tree.md | 2 +- .../linq/modifying-xml-trees-linq-to-xml.md | 14 +- .../concepts/linq/parsing-xml.md | 14 +- .../concepts/linq/partitioning-data.md | 10 +- .../concepts/linq/performance-linq-to-xml.md | 10 +- ...formance-of-chained-queries-linq-to-xml.md | 2 +- ...hite-space-while-loading-or-parsing-xml.md | 4 +- ...reserving-white-space-while-serializing.md | 2 +- .../linq/programming-guide-linq-to-xml.md | 24 +- .../concepts/linq/programming-with-nodes.md | 2 +- .../projecting-xml-in-a-different-shape.md | 6 +- .../concepts/linq/projection-operations.md | 12 +- ...ections-and-transformations-linq-to-xml.md | 18 +- .../pure-functional-transformations-of-xml.md | 10 +- .../concepts/linq/quantifier-operations.md | 6 +- ...ion-syntax-for-standard-query-operators.md | 52 +- ...ng-an-xdocument-vs-querying-an-xelement.md | 2 +- .../concepts/linq/querying-xml-trees.md | 16 +- .../linq/refactoring-into-pure-functions.md | 8 +- .../linq/refactoring-using-a-pure-function.md | 12 +- .../refactoring-using-an-extension-method.md | 10 +- .../concepts/linq/reference-linq-to-xml.md | 2 +- ...s-attributes-and-nodes-from-an-xml-tree.md | 6 +- ...rieving-the-paragraphs-and-their-styles.md | 12 +- .../retrieving-the-text-of-the-paragraphs.md | 14 +- .../linq/sample-xml-documents-linq-to-xml.md | 28 +- .../linq/sample-xml-file-books-linq-to-xml.md | 2 +- ...e-xml-file-consolidated-purchase-orders.md | 2 +- ...ile-customers-and-orders-in-a-namespace.md | 2 +- ...l-file-customers-and-orders-linq-to-xml.md | 6 +- ...multiple-purchase-orders-in-a-namespace.md | 2 +- ...le-multiple-purchase-orders-linq-to-xml.md | 2 +- ...-xml-file-numerical-data-in-a-namespace.md | 2 +- ...ple-xml-file-numerical-data-linq-to-xml.md | 2 +- ...-file-test-configuration-in-a-namespace.md | 2 +- ...xml-file-test-configuration-linq-to-xml.md | 2 +- ...e-typical-purchase-order-in-a-namespace.md | 2 +- ...file-typical-purchase-order-linq-to-xml.md | 2 +- .../sample-xsd-file-customers-and-orders.md | 6 +- ...ct-graphs-that-contain-xelement-objects.md | 6 +- ...rializing-to-an-xmlreader-invoking-xslt.md | 2 +- ...ing-to-files-textwriters-and-xmlwriters.md | 2 +- .../serializing-with-an-xml-declaration.md | 2 +- .../concepts/linq/serializing-xml-trees.md | 10 +- .../concepts/linq/set-operations.md | 8 +- .../shape-of-wordprocessingml-documents.md | 2 +- .../concepts/linq/sorting-data.md | 8 +- .../linq/standard-query-operators-overview.md | 38 +- ...statically-compiled-queries-linq-to-xml.md | 4 +- ...yle-part-of-a-wordprocessingml-document.md | 2 +- .../linq/tutorial-deferred-execution.md | 6 +- ...-content-in-a-wordprocessingml-document.md | 24 +- .../type-relationships-in-query-operations.md | 20 +- .../using-xslt-to-transform-an-xml-tree.md | 2 +- ...ntent-of-xelement-and-xdocument-objects.md | 2 +- ...l-studio-ide-and-tools-support-for-linq.md | 2 +- .../linq/walkthrough-writing-queries.md | 30 +- .../wordprocessingml-document-with-styles.md | 4 +- .../linq/working-with-xml-namespaces.md | 14 +- .../linq/writing-your-first-linq-query.md | 12 +- .../linq/xattribute-class-overview.md | 2 +- .../concepts/linq/xdocument-class-overview.md | 2 +- .../concepts/linq/xelement-class-overview.md | 14 +- .../concepts/object-oriented-programming.md | 84 +-- .../programming-guide/concepts/reflection.md | 2 +- ...ow-to-read-object-data-from-an-xml-file.md | 8 +- ...how-to-write-object-data-to-an-xml-file.md | 4 +- .../concepts/serialization/index.md | 6 +- ...h-persisting-an-object-in-visual-studio.md | 6 +- docs/visual-basic/programming-guide/index.md | 10 +- .../arrays/array-dimensions.md | 4 +- ...ow-to-assign-one-array-to-another-array.md | 12 +- .../how-to-initialize-an-array-variable.md | 6 +- .../language-features/arrays/index.md | 18 +- .../arrays/troubleshooting-arrays.md | 6 +- ...ection-used-by-a-collection-initializer.md | 4 +- ...method-used-by-a-collection-initializer.md | 4 +- .../collection-initializers/index.md | 30 +- .../constant-and-literal-data-types.md | 22 +- .../constants-enums/constants-overview.md | 18 +- .../enumerations-and-name-qualification.md | 20 +- .../constants-enums/enumerations-overview.md | 24 +- .../how-to-declare-a-constant.md | 8 +- .../how-to-declare-enumerations.md | 18 +- ...ng-associated-with-an-enumeration-value.md | 12 +- ...-group-related-constant-values-together.md | 14 +- .../how-to-iterate-through-an-enumeration.md | 14 +- .../how-to-refer-to-an-enumeration-member.md | 12 +- .../constants-enums/index.md | 14 +- .../constants-enums/user-defined-constants.md | 20 +- .../when-to-use-an-enumeration.md | 18 +- .../control-flow/decision-structures.md | 16 +- .../how-to-dispose-of-a-system-resource.md | 14 +- .../control-flow/loop-structures.md | 16 +- .../control-flow/nested-control-structures.md | 8 +- .../control-flow/other-control-structures.md | 16 +- ...lkthrough-implementing-ienumerable-of-t.md | 8 +- .../data-types/array-conversions.md | 20 +- .../data-types/character-data-types.md | 20 +- .../data-types/composite-data-types.md | 20 +- ...ersions-between-strings-and-other-types.md | 16 +- .../data-types/efficient-use-of-data-types.md | 8 +- .../data-types/elementary-data-types.md | 10 +- .../data-types/generic-procedures.md | 14 +- .../data-types/generic-types.md | 30 +- ...ow-to-convert-an-object-to-another-type.md | 18 +- .../data-types/how-to-declare-a-structure.md | 30 +- ...hat-can-provide-identical-functionality.md | 14 +- ...-hold-more-than-one-value-in-a-variable.md | 22 +- .../data-types/how-to-use-a-generic-class.md | 14 +- .../implicit-and-explicit-conversions.md | 56 +- .../language-features/data-types/index.md | 36 +- .../data-types/miscellaneous-data-types.md | 20 +- .../data-types/numeric-data-types.md | 20 +- .../data-types/structure-variables.md | 22 +- .../data-types/structures-and-classes.md | 18 +- ...ructures-and-other-programming-elements.md | 20 +- .../data-types/structures.md | 12 +- .../data-types/troubleshooting-data-types.md | 34 +- .../data-types/type-characters.md | 14 +- .../data-types/type-conversions.md | 16 +- .../value-types-and-reference-types.md | 16 +- .../widening-and-narrowing-conversions.md | 58 +- .../declared-element-characteristics.md | 24 +- .../declared-element-names.md | 8 +- ...rences-between-shadowing-and-overriding.md | 14 +- ...ss-a-variable-hidden-by-a-derived-class.md | 18 +- ...-control-the-availability-of-a-variable.md | 24 +- .../how-to-control-the-scope-of-a-variable.md | 20 +- ...ble-with-the-same-name-as-your-variable.md | 22 +- .../how-to-hide-an-inherited-variable.md | 2 +- .../declared-elements/index.md | 40 +- .../declared-elements/lifetime.md | 22 +- .../references-to-declared-elements.md | 20 +- .../declared-elements/scope.md | 30 +- .../declared-elements/shadowing.md | 24 +- .../declared-elements/type-promotion.md | 14 +- .../how-to-invoke-a-delegate-method.md | 6 +- ...to-pass-procedures-to-another-procedure.md | 8 +- .../language-features/delegates/index.md | 10 +- .../delegates/relaxed-delegate-conversion.md | 12 +- ...-property-or-method-using-a-string-name.md | 2 +- .../determining-object-type.md | 10 +- .../early-late-binding/index.md | 4 +- .../working-with-dynamic-objects.md | 2 +- .../language-features/error-types.md | 2 +- ...declare-custom-events-to-avoid-blocking.md | 4 +- ...eclare-custom-events-to-conserve-memory.md | 4 +- .../language-features/events/index.md | 12 +- ...roubleshooting-inherited-event-handlers.md | 6 +- ...alkthrough-declaring-and-raising-events.md | 8 +- .../events/walkthrough-handling-events.md | 6 +- .../language-features/index.md | 42 +- .../language-features/interfaces/index.md | 4 +- ...gh-creating-and-implementing-interfaces.md | 8 +- ...o-call-a-stored-procedure-by-using-linq.md | 4 +- ...o-combine-data-with-linq-by-using-joins.md | 14 +- ...count-sum-or-average-data-by-using-linq.md | 10 +- ...w-to-filter-query-results-by-using-linq.md | 6 +- ...imum-or-maximum-value-in-a-query-result.md | 6 +- ...modify-data-in-a-database-by-using-linq.md | 4 +- .../how-to-query-a-database-by-using-linq.md | 4 +- ...-a-linq-query-result-as-a-specific-type.md | 6 +- ...how-to-sort-query-results-by-using-linq.md | 6 +- .../language-features/linq/index.md | 24 +- .../linq/introduction-to-linq.md | 34 +- .../anonymous-type-definition.md | 4 +- .../objects-and-classes/anonymous-types.md | 20 +- ...n-object-by-using-an-object-initializer.md | 12 +- ...nd-types-in-anonymous-type-declarations.md | 8 +- .../objects-and-classes/index.md | 40 +- .../objects-and-classes/inheritance-basics.md | 8 +- ...-initializers-named-and-anonymous-types.md | 18 +- ...e-how-objects-are-created-and-destroyed.md | 4 +- .../overloaded-properties-and-methods.md | 18 +- .../walkthrough-defining-classes.md | 4 +- .../arithmetic-operators.md | 34 +- .../boolean-expressions.md | 22 +- ...s-performed-with-visual-basic-operators.md | 66 +-- .../comparison-operators.md | 20 +- .../concatenation-operators.md | 14 +- .../efficient-combination-of-operators.md | 18 +- .../how-to-calculate-numeric-values.md | 16 +- ...how-to-match-a-string-against-a-pattern.md | 14 +- ...o-test-whether-two-objects-are-the-same.md | 4 +- .../operators-and-expressions/index.md | 18 +- .../logical-and-bitwise-operators.md | 24 +- .../value-comparisons.md | 10 +- .../procedures/auto-implemented-properties.md | 8 +- ...onsiderations-in-overloading-procedures.md | 8 +- ...-modifiable-and-nonmodifiable-arguments.md | 6 +- ...rences-between-parameters-and-arguments.md | 2 +- ...g-an-argument-by-value-and-by-reference.md | 6 +- ...rences-between-properties-and-variables.md | 4 +- .../procedures/function-procedures.md | 2 +- ...-procedure-that-does-not-return-a-value.md | 2 +- ...o-call-a-procedure-that-returns-a-value.md | 2 +- .../how-to-call-a-property-procedure.md | 6 +- .../how-to-call-an-extension-method.md | 2 +- .../how-to-call-an-operator-procedure.md | 16 +- .../how-to-call-an-overloaded-procedure.md | 2 +- ...hange-the-value-of-a-procedure-argument.md | 10 +- .../how-to-create-a-lambda-expression.md | 12 +- ...create-a-procedure-that-returns-a-value.md | 2 +- .../procedures/how-to-create-a-property.md | 6 +- ...are-a-property-with-mixed-access-levels.md | 4 +- ...-to-declare-and-call-a-default-property.md | 8 +- .../how-to-define-a-conversion-operator.md | 12 +- ...w-to-define-a-parameter-for-a-procedure.md | 10 +- .../procedures/how-to-define-an-operator.md | 8 +- ...define-multiple-versions-of-a-procedure.md | 2 +- ...force-an-argument-to-be-passed-by-value.md | 10 +- .../how-to-get-a-value-from-a-property.md | 2 +- ...akes-an-indefinite-number-of-parameters.md | 6 +- ...rocedure-that-takes-optional-parameters.md | 6 +- .../how-to-pass-arguments-to-a-procedure.md | 6 +- ...rocedure-argument-against-value-changes.md | 8 +- .../how-to-put-a-value-in-a-property.md | 2 +- .../how-to-return-a-value-from-a-procedure.md | 6 +- ...w-to-use-a-class-that-defines-operators.md | 18 +- .../language-features/procedures/index.md | 8 +- .../procedures/lambda-expressions.md | 24 +- .../procedures/operator-procedures.md | 8 +- .../procedures/optional-parameters.md | 4 +- .../procedures/overload-resolution.md | 6 +- .../procedures/parameter-arrays.md | 12 +- .../procedures/partial-methods.md | 6 +- ...ssing-arguments-by-position-and-by-name.md | 4 +- ...ing-arguments-by-value-and-by-reference.md | 8 +- .../procedures/procedure-overloading.md | 6 +- .../procedure-parameters-and-arguments.md | 6 +- .../procedures/property-procedures.md | 6 +- .../language-features/statements.md | 32 +- .../strings/how-culture-affects-strings.md | 6 +- .../how-to-access-characters-in-strings.md | 8 +- ...vert-a-string-to-an-array-of-characters.md | 6 +- ...convert-an-array-of-bytes-into-a-string.md | 2 +- ...-convert-strings-into-an-array-of-bytes.md | 2 +- ...e-a-string-from-an-array-of-char-values.md | 4 +- .../how-to-validate-file-names-and-paths.md | 2 +- ...e-strings-that-represent-dates-or-times.md | 2 +- .../language-features/strings/index.md | 14 +- .../strings/introduction-to-strings.md | 8 +- .../strings/nothing-and-strings.md | 2 +- .../strings/string-basics.md | 6 +- .../types-of-string-manipulation-methods.md | 4 +- ...ressions-with-the-maskedtextbox-control.md | 2 +- .../strings/validating-strings.md | 10 +- ...h-validating-that-passwords-are-complex.md | 2 +- .../zero-based-vs-one-based-string-access.md | 2 +- .../how-to-access-members-of-an-object.md | 12 +- .../variables/how-to-create-a-new-variable.md | 26 +- ...-variable-that-does-not-change-in-value.md | 12 +- ...ect-variable-and-assign-an-object-to-it.md | 16 +- ...-what-type-an-object-variable-refers-to.md | 12 +- ...rmine-whether-two-objects-are-identical.md | 16 +- ...termine-whether-two-objects-are-related.md | 8 +- ...ject-variable-not-refer-to-any-instance.md | 10 +- ...to-move-data-into-and-out-of-a-variable.md | 6 +- ...er-to-the-current-instance-of-an-object.md | 6 +- ...n-object-with-a-long-qualification-path.md | 4 +- .../language-features/variables/index.md | 18 +- .../variables/local-type-inference.md | 16 +- .../variables/object-variable-assignment.md | 18 +- .../variables/object-variable-declaration.md | 20 +- .../variables/object-variable-values.md | 24 +- .../variables/object-variables.md | 10 +- .../variables/troubleshooting-variables.md | 28 +- .../variables/variable-declaration.md | 36 +- .../language-features/xml/accessing-xml.md | 18 +- .../language-features/xml/creating-xml.md | 16 +- .../xml/embedded-expressions-in-xml.md | 14 +- .../xml/how-to-access-xml-attributes.md | 6 +- .../xml/how-to-access-xml-child-elements.md | 8 +- .../how-to-access-xml-descendant-elements.md | 8 +- .../xml/how-to-create-xml-literals.md | 8 +- ...-declare-and-use-xml-namespace-prefixes.md | 10 +- ...ow-to-embed-expressions-in-xml-literals.md | 10 +- ...o-load-xml-from-a-file-string-or-stream.md | 8 +- .../xml/how-to-modify-xml-literals.md | 12 +- .../xml/how-to-transform-xml-by-using-linq.md | 16 +- .../language-features/xml/index.md | 14 +- .../language-features/xml/manipulating-xml.md | 22 +- ...of-declared-xml-elements-and-attributes.md | 8 +- .../xml/overview-of-linq-to-xml.md | 18 +- .../xml/white-space-in-xml-literals.md | 2 +- ...-literals-and-the-xml-1-0-specification.md | 6 +- .../xml/xml-literals-overview.md | 22 +- .../program-structure/comments-in-code.md | 8 +- .../conditional-compilation.md | 10 +- .../documenting-your-code-with-xml.md | 14 +- ...to-break-and-combine-statements-in-code.md | 6 +- ...w-to-collapse-and-hide-sections-of-code.md | 6 +- .../how-to-create-xml-documentation.md | 8 +- .../how-to-label-statements.md | 6 +- .../keywords-as-element-names-in-code.md | 6 +- .../program-structure/limitations.md | 12 +- .../program-structure/main-procedure.md | 14 +- .../me-my-mybase-and-myclass.md | 2 +- .../program-structure/namespaces.md | 2 +- .../program-structure/naming-conventions.md | 10 +- .../processing-the-xml-file.md | 6 +- .../program-structure-and-code-conventions.md | 32 +- .../special-characters-in-code.md | 8 +- .../structure-of-a-visual-basic-program.md | 38 +- .../command-line-compiler/addmodule.md | 12 +- .../command-line-compiler/baseaddress.md | 6 +- .../building-from-the-command-line.md | 8 +- .../command-line-compiler/codepage.md | 2 +- .../compiler-options-listed-alphabetically.md | 106 ++-- .../compiler-options-listed-by-category.md | 104 ++-- .../reference/command-line-compiler/debug.md | 6 +- .../reference/command-line-compiler/define.md | 8 +- .../command-line-compiler/delaysign.md | 10 +- .../command-line-compiler/deterministic.md | 4 +- .../reference/command-line-compiler/doc.md | 12 +- .../command-line-compiler/errorreport.md | 10 +- .../command-line-compiler/filealign.md | 2 +- .../reference/command-line-compiler/help.md | 4 +- .../command-line-compiler/highentropyva.md | 6 +- ...how-to-invoke-the-command-line-compiler.md | 4 +- .../command-line-compiler/imports.md | 8 +- .../reference/command-line-compiler/index.md | 6 +- .../command-line-compiler/keycontainer.md | 10 +- .../command-line-compiler/keyfile.md | 12 +- .../command-line-compiler/langversion.md | 4 +- .../command-line-compiler/libpath.md | 6 +- .../reference/command-line-compiler/link.md | 2 +- .../command-line-compiler/linkresource.md | 8 +- .../reference/command-line-compiler/main.md | 10 +- .../moduleassemblyname.md | 14 +- .../reference/command-line-compiler/netcf.md | 12 +- .../command-line-compiler/noconfig.md | 10 +- .../reference/command-line-compiler/nologo.md | 4 +- .../command-line-compiler/nostdlib.md | 8 +- .../reference/command-line-compiler/nowarn.md | 4 +- .../command-line-compiler/nowin32manifest.md | 4 +- .../command-line-compiler/optimize.md | 10 +- .../command-line-compiler/optioncompare.md | 14 +- .../command-line-compiler/optionexplicit.md | 14 +- .../command-line-compiler/optioninfer.md | 20 +- .../command-line-compiler/optionstrict.md | 18 +- .../reference/command-line-compiler/out.md | 6 +- .../reference/command-line-compiler/quiet.md | 4 +- .../command-line-compiler/recurse.md | 6 +- .../command-line-compiler/reference.md | 14 +- .../command-line-compiler/removeintchecks.md | 4 +- .../command-line-compiler/resource.md | 10 +- .../command-line-compiler/rootnamespace.md | 4 +- .../sample-compilation-command-lines.md | 4 +- .../command-line-compiler/sdkpath.md | 12 +- .../specify-response-file.md | 8 +- .../command-line-compiler/subsystemversion.md | 8 +- .../reference/command-line-compiler/target.md | 16 +- .../command-line-compiler/utf8output.md | 4 +- .../command-line-compiler/vbruntime.md | 8 +- .../command-line-compiler/verbose.md | 4 +- .../command-line-compiler/warnaserror.md | 6 +- .../command-line-compiler/win32icon.md | 6 +- .../command-line-compiler/win32manifest.md | 6 +- .../command-line-compiler/win32resource.md | 6 +- docs/visual-basic/reference/index.md | 8 +- .../reference/language-specification/index.md | 2 +- 2246 files changed, 8544 insertions(+), 8544 deletions(-) diff --git a/docs/visual-basic/developing-apps/accessing-data.md b/docs/visual-basic/developing-apps/accessing-data.md index bbc54da625404..bd8f05e62df48 100644 --- a/docs/visual-basic/developing-apps/accessing-data.md +++ b/docs/visual-basic/developing-apps/accessing-data.md @@ -18,7 +18,7 @@ Provides links to pages that discuss incorporating data access functionality int [Visual Studio data tools for .NET](/visualstudio/data-tools/visual-studio-data-tools-for-dotnet) Provides links to pages on creating applications that work with data, using Visual Studio. -[LINQ](../../visual-basic/programming-guide/language-features/linq/index.md) +[LINQ](../programming-guide/language-features/linq/index.md) Provides links to topics that describe how to use LINQ with Visual Basic. [LINQ to SQL](../../framework/data/adonet/sql/linq/index.md) diff --git a/docs/visual-basic/developing-apps/customizing-extending-my/customizing-which-objects-are-available-in-my.md b/docs/visual-basic/developing-apps/customizing-extending-my/customizing-which-objects-are-available-in-my.md index e7a9fe5e1ed52..09d0645ecdec3 100644 --- a/docs/visual-basic/developing-apps/customizing-extending-my/customizing-which-objects-are-available-in-my.md +++ b/docs/visual-basic/developing-apps/customizing-extending-my/customizing-which-objects-are-available-in-my.md @@ -72,10 +72,10 @@ The `_MYTYPE` conditional-compilation constant, in turn, controls the values of - - - -- [How My Depends on Project Type](../../../visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md) -- [Conditional Compilation](../../../visual-basic/programming-guide/program-structure/conditional-compilation.md) -- [-define (Visual Basic)](../../../visual-basic/reference/command-line-compiler/define.md) -- [My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md) -- [My.Request Object](../../../visual-basic/language-reference/objects/my-request-object.md) -- [My.Response Object](../../../visual-basic/language-reference/objects/my-response-object.md) -- [My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md) +- [How My Depends on Project Type](../development-with-my/how-my-depends-on-project-type.md) +- [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) +- [-define (Visual Basic)](../../reference/command-line-compiler/define.md) +- [My.Forms Object](../../language-reference/objects/my-forms-object.md) +- [My.Request Object](../../language-reference/objects/my-request-object.md) +- [My.Response Object](../../language-reference/objects/my-response-object.md) +- [My.WebServices Object](../../language-reference/objects/my-webservices-object.md) diff --git a/docs/visual-basic/developing-apps/customizing-extending-my/extending-the-visual-basic-application-model.md b/docs/visual-basic/developing-apps/customizing-extending-my/extending-the-visual-basic-application-model.md index dab4a42390d8c..eadee81f098cb 100644 --- a/docs/visual-basic/developing-apps/customizing-extending-my/extending-the-visual-basic-application-model.md +++ b/docs/visual-basic/developing-apps/customizing-extending-my/extending-the-visual-basic-application-model.md @@ -96,5 +96,5 @@ If the application is a normal application (multiple-instance application), or t - - - -- [Overview of the Visual Basic Application Model](../../../visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md) +- [Overview of the Visual Basic Application Model](../development-with-my/overview-of-the-visual-basic-application-model.md) - [Application Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/application-page-project-designer-visual-basic) diff --git a/docs/visual-basic/developing-apps/customizing-extending-my/packaging-and-deploying-custom-my-extensions.md b/docs/visual-basic/developing-apps/customizing-extending-my/packaging-and-deploying-custom-my-extensions.md index 71cbc032bd1ea..5b68abc57a7b0 100644 --- a/docs/visual-basic/developing-apps/customizing-extending-my/packaging-and-deploying-custom-my-extensions.md +++ b/docs/visual-basic/developing-apps/customizing-extending-my/packaging-and-deploying-custom-my-extensions.md @@ -23,7 +23,7 @@ This topic discusses how to package a custom `My` extension as a hidden item tem ## Create a My namespace extension -The first step in creating a deployment package for a custom `My` extension is to create the extension as a single code file. For details and guidance about how to create a custom `My` extension, see [Extending the My Namespace in Visual Basic](../../../visual-basic/developing-apps/customizing-extending-my/extending-the-my-namespace.md). +The first step in creating a deployment package for a custom `My` extension is to create the extension as a single code file. For details and guidance about how to create a custom `My` extension, see [Extending the My Namespace in Visual Basic](extending-the-my-namespace.md). ## Export a My namespace extension as an item template @@ -97,7 +97,7 @@ To install the template, you can copy the compressed folder (*.zip* file) to the ## See also -- [Extending the My Namespace in Visual Basic](../../../visual-basic/developing-apps/customizing-extending-my/extending-the-my-namespace.md) -- [Extending the Visual Basic Application Model](../../../visual-basic/developing-apps/customizing-extending-my/extending-the-visual-basic-application-model.md) -- [Customizing Which Objects are Available in My](../../../visual-basic/developing-apps/customizing-extending-my/customizing-which-objects-are-available-in-my.md) +- [Extending the My Namespace in Visual Basic](extending-the-my-namespace.md) +- [Extending the Visual Basic Application Model](extending-the-visual-basic-application-model.md) +- [Customizing Which Objects are Available in My](customizing-which-objects-are-available-in-my.md) - [My Extensions Page, Project Designer](/visualstudio/ide/reference/my-extensions-page-project-designer-visual-basic) diff --git a/docs/visual-basic/developing-apps/development-with-my/default-object-instances-provided-by-my-forms-and-my-webservices.md b/docs/visual-basic/developing-apps/development-with-my/default-object-instances-provided-by-my-forms-and-my-webservices.md index 7512be244e28a..8a9a5321e78b4 100644 --- a/docs/visual-basic/developing-apps/development-with-my/default-object-instances-provided-by-my-forms-and-my-webservices.md +++ b/docs/visual-basic/developing-apps/development-with-my/default-object-instances-provided-by-my-forms-and-my-webservices.md @@ -10,7 +10,7 @@ ms.assetid: de930027-9108-4f0c-b97c-5e7db4d6ef79 --- # Default Object Instances Provided by My.Forms and My.WebServices (Visual Basic) -The [My.Forms](../../../visual-basic/language-reference/objects/my-forms-object.md) and [My.WebServices](../../../visual-basic/language-reference/objects/my-webservices-object.md) objects provide access to forms, data sources, and XML Web services used by your application. They do this by providing collections of *default instances* of each of these objects. +The [My.Forms](../../language-reference/objects/my-forms-object.md) and [My.WebServices](../../language-reference/objects/my-webservices-object.md) objects provide access to forms, data sources, and XML Web services used by your application. They do this by providing collections of *default instances* of each of these objects. ## Default Instances @@ -24,6 +24,6 @@ The [My.Forms](../../../visual-basic/language-reference/objects/my-forms-object. ## See also -- [My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md) -- [My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md) -- [How My Depends on Project Type](../../../visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md) +- [My.Forms Object](../../language-reference/objects/my-forms-object.md) +- [My.WebServices Object](../../language-reference/objects/my-webservices-object.md) +- [How My Depends on Project Type](how-my-depends-on-project-type.md) diff --git a/docs/visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md b/docs/visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md index f864f31c82cbb..2cde4f58ac559 100644 --- a/docs/visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md +++ b/docs/visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md @@ -58,10 +58,10 @@ ms.assetid: c188b38e-bd9d-4121-9983-41ea6a94d28e - - - -- [Customizing Which Objects are Available in My](../../../visual-basic/developing-apps/customizing-extending-my/customizing-which-objects-are-available-in-my.md) -- [Conditional Compilation](../../../visual-basic/programming-guide/program-structure/conditional-compilation.md) -- [-define (Visual Basic)](../../../visual-basic/reference/command-line-compiler/define.md) -- [My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md) -- [My.Request Object](../../../visual-basic/language-reference/objects/my-request-object.md) -- [My.Response Object](../../../visual-basic/language-reference/objects/my-response-object.md) -- [My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md) +- [Customizing Which Objects are Available in My](../customizing-extending-my/customizing-which-objects-are-available-in-my.md) +- [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) +- [-define (Visual Basic)](../../reference/command-line-compiler/define.md) +- [My.Forms Object](../../language-reference/objects/my-forms-object.md) +- [My.Request Object](../../language-reference/objects/my-request-object.md) +- [My.Response Object](../../language-reference/objects/my-response-object.md) +- [My.WebServices Object](../../language-reference/objects/my-webservices-object.md) diff --git a/docs/visual-basic/developing-apps/development-with-my/index.md b/docs/visual-basic/developing-apps/development-with-my/index.md index 00f208967c201..fecd6090fec28 100644 --- a/docs/visual-basic/developing-apps/development-with-my/index.md +++ b/docs/visual-basic/developing-apps/development-with-my/index.md @@ -22,19 +22,19 @@ Visual Basic provides new features for rapid application development that improv ## In This Section - [Performing Tasks with My.Application, My.Computer, and My.User](../../../visual-basic/developing-apps/development-with-my/performing-tasks-with-my-application-my-computer-and-my-user.md) + [Performing Tasks with My.Application, My.Computer, and My.User](performing-tasks-with-my-application-my-computer-and-my-user.md) Describes the three central `My` objects, `My.Application`, `My.Computer`, and `My.User`, which provide access to information and functionality - [Default Object Instances Provided by My.Forms and My.WebServices](../../../visual-basic/developing-apps/development-with-my/default-object-instances-provided-by-my-forms-and-my-webservices.md) + [Default Object Instances Provided by My.Forms and My.WebServices](default-object-instances-provided-by-my-forms-and-my-webservices.md) Describes the `My.Forms` and `My.WebServices` objects, which provide access to forms, data sources, and XML Web services used by your application. - [Rapid Application Development with My.Resources and My.Settings](../../../visual-basic/developing-apps/development-with-my/rapid-application-development-with-my-resources-and-my-settings.md) + [Rapid Application Development with My.Resources and My.Settings](rapid-application-development-with-my-resources-and-my-settings.md) Describes the `My.Resources` and `My.Settings` objects, which provide access to an application's resources and settings. - [Overview of the Visual Basic Application Model](../../../visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md) + [Overview of the Visual Basic Application Model](overview-of-the-visual-basic-application-model.md) Describes the Visual Basic Application Startup/Shutdown model. - [How My Depends on Project Type](../../../visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md) + [How My Depends on Project Type](how-my-depends-on-project-type.md) Gives details on which `My` features are available in different project types. ## See also @@ -42,6 +42,6 @@ Visual Basic provides new features for rapid application development that improv - - - -- [My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md) -- [My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md) -- [How My Depends on Project Type](../../../visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md) +- [My.Forms Object](../../language-reference/objects/my-forms-object.md) +- [My.WebServices Object](../../language-reference/objects/my-webservices-object.md) +- [How My Depends on Project Type](how-my-depends-on-project-type.md) diff --git a/docs/visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md b/docs/visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md index ee30482f20ffa..65bb99bac8a9a 100644 --- a/docs/visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md +++ b/docs/visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md @@ -61,4 +61,4 @@ Visual Basic provides a well-defined model for controlling the behavior of Windo - - - -- [Extending the Visual Basic Application Model](../../../visual-basic/developing-apps/customizing-extending-my/extending-the-visual-basic-application-model.md) +- [Extending the Visual Basic Application Model](../customizing-extending-my/extending-the-visual-basic-application-model.md) diff --git a/docs/visual-basic/developing-apps/development-with-my/performing-tasks-with-my-application-my-computer-and-my-user.md b/docs/visual-basic/developing-apps/development-with-my/performing-tasks-with-my-application-my-computer-and-my-user.md index 6351cfdefd94a..3a0471ccf9e74 100644 --- a/docs/visual-basic/developing-apps/development-with-my/performing-tasks-with-my-application-my-computer-and-my-user.md +++ b/docs/visual-basic/developing-apps/development-with-my/performing-tasks-with-my-application-my-computer-and-my-user.md @@ -37,4 +37,4 @@ The three central `My` objects that provide access to information and commonly u - - - -- [How My Depends on Project Type](../../../visual-basic/developing-apps/development-with-my/how-my-depends-on-project-type.md) +- [How My Depends on Project Type](how-my-depends-on-project-type.md) diff --git a/docs/visual-basic/developing-apps/development-with-my/rapid-application-development-with-my-resources-and-my-settings.md b/docs/visual-basic/developing-apps/development-with-my/rapid-application-development-with-my-resources-and-my-settings.md index aa7654f54e065..587fa39dbca29 100644 --- a/docs/visual-basic/developing-apps/development-with-my/rapid-application-development-with-my-resources-and-my-settings.md +++ b/docs/visual-basic/developing-apps/development-with-my/rapid-application-development-with-my-resources-and-my-settings.md @@ -20,10 +20,10 @@ The `My.Resources` object provides access to the application's resources and all The `My.Resources` object exposes only global resources. It does not provide access to resource files associated with forms. You must access the form resources from the form. - Similarly, the `My.Settings` object provides access to the application's settings and allows you to dynamically store and retrieve property settings and other information for your application. For more information, see [My.Resources Object](../../../visual-basic/language-reference/objects/my-resources-object.md) and [My.Settings Object](../../../visual-basic/language-reference/objects/my-settings-object.md). + Similarly, the `My.Settings` object provides access to the application's settings and allows you to dynamically store and retrieve property settings and other information for your application. For more information, see [My.Resources Object](../../language-reference/objects/my-resources-object.md) and [My.Settings Object](../../language-reference/objects/my-settings-object.md). ## See also -- [My.Resources Object](../../../visual-basic/language-reference/objects/my-resources-object.md) -- [My.Settings Object](../../../visual-basic/language-reference/objects/my-settings-object.md) -- [Accessing Application Settings](../../../visual-basic/developing-apps/programming/app-settings/index.md) +- [My.Resources Object](../../language-reference/objects/my-resources-object.md) +- [My.Settings Object](../../language-reference/objects/my-settings-object.md) +- [Accessing Application Settings](../programming/app-settings/index.md) diff --git a/docs/visual-basic/developing-apps/index.md b/docs/visual-basic/developing-apps/index.md index 1c2174f92f5dd..e2c5887b99aa7 100644 --- a/docs/visual-basic/developing-apps/index.md +++ b/docs/visual-basic/developing-apps/index.md @@ -12,28 +12,28 @@ This section covers conceptual documentation for the Visual Basic language. ## In This Section - [Programming in Visual Basic](../../visual-basic/developing-apps/programming/index.md) + [Programming in Visual Basic](programming/index.md) Covers a variety of programming subjects. - [Development with My](../../visual-basic/developing-apps/development-with-my/index.md) + [Development with My](development-with-my/index.md) Discusses a new feature called `My`, which provides access to information and default object instances that are related to an application and its run-time environment. - [Accessing Data in Visual Basic Applications](../../visual-basic/developing-apps/accessing-data.md) + [Accessing Data in Visual Basic Applications](accessing-data.md) Contains Help on accessing data in Visual Basic. - [Creating and Using Components in Visual Basic](../../visual-basic/developing-apps/creating-and-using-components.md) + [Creating and Using Components in Visual Basic](creating-and-using-components.md) Defines the term *component* and discusses how and when to create components. - [Windows Forms Application Basics](../../visual-basic/developing-apps/windows-forms/index.md) + [Windows Forms Application Basics](windows-forms/index.md) Provides information about creating Windows Forms applications by using Visual Studio. - [Customizing Projects and Extending My](../../visual-basic/developing-apps/customizing-extending-my/index.md) + [Customizing Projects and Extending My](customizing-extending-my/index.md) Describes how you can customize project templates to provide additional `My` objects. ## Related Sections - [Visual Basic Programming Guide](../../visual-basic/programming-guide/index.md) + [Visual Basic Programming Guide](../programming-guide/index.md) Walks through the essential elements of programming with Visual Basic. - [Visual Basic Language Reference](../../visual-basic/language-reference/index.md) + [Visual Basic Language Reference](../language-reference/index.md) Contains reference documentation for the Visual Basic language. diff --git a/docs/visual-basic/developing-apps/programming/accessing-application-forms.md b/docs/visual-basic/developing-apps/programming/accessing-application-forms.md index 6ef8a046af20f..c399f2cb07cf8 100644 --- a/docs/visual-basic/developing-apps/programming/accessing-application-forms.md +++ b/docs/visual-basic/developing-apps/programming/accessing-application-forms.md @@ -19,7 +19,7 @@ The `My.Forms` object provides an easy way to access an instance of each Windows |To|See| |---|---| -|Access one form from another form in an application.|[My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md)| +|Access one form from another form in an application.|[My.Forms Object](../../language-reference/objects/my-forms-object.md)| |Display the titles of all the application's open forms.|| |Update the splash screen with status information as the application starts.|| @@ -27,4 +27,4 @@ The `My.Forms` object provides an easy way to access an instance of each Windows - - -- [My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md) +- [My.Forms Object](../../language-reference/objects/my-forms-object.md) diff --git a/docs/visual-basic/developing-apps/programming/accessing-application-web-services.md b/docs/visual-basic/developing-apps/programming/accessing-application-web-services.md index 2d8d7efd19d47..dd8aeed7495d0 100644 --- a/docs/visual-basic/developing-apps/programming/accessing-application-web-services.md +++ b/docs/visual-basic/developing-apps/programming/accessing-application-web-services.md @@ -17,9 +17,9 @@ The following table lists possible ways to access Web services referenced by an |To|See| |---|---| -|Call a Web service|[My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md)| -|Call a Web service asynchronously and handle an event when it completes|[How to: Call a Web Service Asynchronously](../../../visual-basic/developing-apps/programming/how-to-call-a-web-service-asynchronously.md)| +|Call a Web service|[My.WebServices Object](../../language-reference/objects/my-webservices-object.md)| +|Call a Web service asynchronously and handle an event when it completes|[How to: Call a Web Service Asynchronously](how-to-call-a-web-service-asynchronously.md)| ## See also -- [My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md) +- [My.WebServices Object](../../language-reference/objects/my-webservices-object.md) diff --git a/docs/visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md b/docs/visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md index bb2e79344223f..30873c7bb1a57 100644 --- a/docs/visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md +++ b/docs/visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md @@ -12,7 +12,7 @@ ms.assetid: 41250181-c594-4854-9988-8183b9eb03cf You can change a user setting by assigning a new value to the setting's property on the `My.Settings` object. - The `My.Settings` object exposes each setting as a property. The property name is the same as the setting name, and the property type is the same as the setting type. The setting's **Scope** determines if the property is read-only: The property for an **Application**-scope setting is read-only, while the property for a **User**-scope setting is read-write. For more information, see [My.Settings Object](../../../../visual-basic/language-reference/objects/my-settings-object.md). + The `My.Settings` object exposes each setting as a property. The property name is the same as the setting name, and the property type is the same as the setting type. The setting's **Scope** determines if the property is read-only: The property for an **Application**-scope setting is read-only, while the property for a **User**-scope setting is read-write. For more information, see [My.Settings Object](../../../language-reference/objects/my-settings-object.md). > [!NOTE] > Although you can change and save the values of user-scope settings at run time, application-scope settings are read-only and cannot be changed programmatically. You can change application-scope settings when you create the application by using the **Project Designer** or by editing the application's configuration file. For more information, see [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet). @@ -25,12 +25,12 @@ You can change a user setting by assigning a new value to the setting's property For this example to work, your application must have a `Nickname` user setting, of type `String`. - The application saves the user settings when the application shuts down. To save the settings immediately, call the `My.Settings.Save` method. For more information, see [How to: Persist User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-persist-user-settings.md). + The application saves the user settings when the application shuts down. To save the settings immediately, call the `My.Settings.Save` method. For more information, see [How to: Persist User Settings in Visual Basic](how-to-persist-user-settings.md). ## See also -- [My.Settings Object](../../../../visual-basic/language-reference/objects/my-settings-object.md) -- [How to: Read Application Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md) -- [How to: Persist User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-persist-user-settings.md) -- [How to: Create Property Grids for User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md) +- [My.Settings Object](../../../language-reference/objects/my-settings-object.md) +- [How to: Read Application Settings in Visual Basic](how-to-read-application-settings.md) +- [How to: Persist User Settings in Visual Basic](how-to-persist-user-settings.md) +- [How to: Create Property Grids for User Settings in Visual Basic](how-to-create-property-grids-for-user-settings.md) - [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet) diff --git a/docs/visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md b/docs/visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md index 962421623ab15..39f93d47a90b0 100644 --- a/docs/visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md +++ b/docs/visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md @@ -15,7 +15,7 @@ You can create a property grid for user settings by populating a [!NOTE] > In order for this example to work, your application must have its user settings configured. For more information, see [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet). - The `My.Settings` object exposes each setting as a property. The property name is the same as the setting name, and the property type is the same as the setting type. The setting's **Scope** determines if the property is read-only; the property for an **Application**-scope setting is read-only, while the property for a **User**-scope setting is read-write. For more information, see [My.Settings Object](../../../../visual-basic/language-reference/objects/my-settings-object.md). + The `My.Settings` object exposes each setting as a property. The property name is the same as the setting name, and the property type is the same as the setting type. The setting's **Scope** determines if the property is read-only; the property for an **Application**-scope setting is read-only, while the property for a **User**-scope setting is read-write. For more information, see [My.Settings Object](../../../language-reference/objects/my-settings-object.md). > [!NOTE] > You cannot change or save the values of application-scope settings at run time. Application-scope settings can be changed only when creating the application (through the **Project Designer**) or by editing the application's configuration file. For more information, see [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet). @@ -43,12 +43,12 @@ You can create a property grid for user settings by populating a [!NOTE] > Although you can change and save the values of user-scope settings at run time, application-scope settings are read-only and cannot be changed programmatically. You can change application-scope settings when creating the application, through the **Project Designer**, or by editing the application's configuration file. For more information, see [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet). @@ -28,8 +28,8 @@ You can use the `My.Settings.Save` method to persist changes to the user setting ## See also -- [My.Settings Object](../../../../visual-basic/language-reference/objects/my-settings-object.md) -- [How to: Read Application Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md) -- [How to: Change User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md) -- [How to: Create Property Grids for User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md) +- [My.Settings Object](../../../language-reference/objects/my-settings-object.md) +- [How to: Read Application Settings in Visual Basic](how-to-read-application-settings.md) +- [How to: Change User Settings in Visual Basic](how-to-change-user-settings.md) +- [How to: Create Property Grids for User Settings in Visual Basic](how-to-create-property-grids-for-user-settings.md) - [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet) diff --git a/docs/visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md b/docs/visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md index 76cfd4d3b2631..96d2505bafe55 100644 --- a/docs/visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md +++ b/docs/visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md @@ -11,7 +11,7 @@ ms.assetid: eb3428ef-115e-49a8-a878-e0613183fee0 You can read a user setting by accessing the setting's property on the `My.Settings` object. - The `My.Settings` object exposes each setting as a property. The property name is the same as the setting name, and the property type is the same as the setting type. The setting's **Scope** indicates if the property is read-only; the property for an **Application** scope setting is read-only, while the property for a **User** scope setting is read-write. For more information, see [My.Settings Object](../../../../visual-basic/language-reference/objects/my-settings-object.md). + The `My.Settings` object exposes each setting as a property. The property name is the same as the setting name, and the property type is the same as the setting type. The setting's **Scope** indicates if the property is read-only; the property for an **Application** scope setting is read-only, while the property for a **User** scope setting is read-write. For more information, see [My.Settings Object](../../../language-reference/objects/my-settings-object.md). ## Example @@ -23,8 +23,8 @@ You can read a user setting by accessing the setting's property on the `My.Setti ## See also -- [My.Settings Object](../../../../visual-basic/language-reference/objects/my-settings-object.md) -- [How to: Change User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md) -- [How to: Persist User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-persist-user-settings.md) -- [How to: Create Property Grids for User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md) +- [My.Settings Object](../../../language-reference/objects/my-settings-object.md) +- [How to: Change User Settings in Visual Basic](how-to-change-user-settings.md) +- [How to: Persist User Settings in Visual Basic](how-to-persist-user-settings.md) +- [How to: Create Property Grids for User Settings in Visual Basic](how-to-create-property-grids-for-user-settings.md) - [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet) diff --git a/docs/visual-basic/developing-apps/programming/app-settings/index.md b/docs/visual-basic/developing-apps/programming/app-settings/index.md index 0b18a0a6ab495..1aaad2c7f4b45 100644 --- a/docs/visual-basic/developing-apps/programming/app-settings/index.md +++ b/docs/visual-basic/developing-apps/programming/app-settings/index.md @@ -22,12 +22,12 @@ This section contains topics describing the `My.Settings` object and the tasks i |To|See| |--------|---------| -|Update the value of a user setting|[How to: Change User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md)| -|Display application and user settings in a property grid|[How to: Create Property Grids for User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md)| -|Save updated user setting values|[How to: Persist User Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-persist-user-settings.md)| -|Determine the values of user settings|[How to: Read Application Settings in Visual Basic](../../../../visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md)| +|Update the value of a user setting|[How to: Change User Settings in Visual Basic](how-to-change-user-settings.md)| +|Display application and user settings in a property grid|[How to: Create Property Grids for User Settings in Visual Basic](how-to-create-property-grids-for-user-settings.md)| +|Save updated user setting values|[How to: Persist User Settings in Visual Basic](how-to-persist-user-settings.md)| +|Determine the values of user settings|[How to: Read Application Settings in Visual Basic](how-to-read-application-settings.md)| ## See also - [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet) -- [My.Settings Object](../../../../visual-basic/language-reference/objects/my-settings-object.md) +- [My.Settings Object](../../../language-reference/objects/my-settings-object.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md b/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md index 4762d6c07c5e3..1fa97ffd12aac 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md @@ -12,19 +12,19 @@ The `My.Computer.Ports` object provides a property and a method for accessing th ## In This Section - [How to: Show Available Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md) + [How to: Show Available Serial Ports](how-to-show-available-serial-ports.md) Demonstrates how to show available serial ports. - [How to: Dial Modems Attached to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md) + [How to: Dial Modems Attached to Serial Ports](how-to-dial-modems-attached-to-serial-ports.md) Demonstrates how to dial a modem attached to the serial port of a computer. - [How to: Send Strings to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md) + [How to: Send Strings to Serial Ports](how-to-send-strings-to-serial-ports.md) Demonstrates how to send a string to a computer's serial port. - [How to: Receive Strings From Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md) + [How to: Receive Strings From Serial Ports](how-to-receive-strings-from-serial-ports.md) Demonstrates how to receive a string from a computer's serial port. - [Port Operations in the .NET Framework](../../../../visual-basic/developing-apps/programming/computer-resources/port-operations-in-the-net-framework.md) + [Port Operations in the .NET Framework](port-operations-in-the-net-framework.md) Describes how to use the .NET Framework when performing port operations. ## Reference diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-keyboard.md b/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-keyboard.md index 54d23e0630fa8..01f2e1e6b81cb 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-keyboard.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/accessing-the-keyboard.md @@ -24,7 +24,7 @@ The `My.Computer.Keyboard` object provides properties for accessing the current |Determine whether the CTRL key is down|| |Determine whether NUM LOCK is on|| |Determine whether SCROLL LOCK is on|| -|Start an application and send it keystrokes|[How to: Start an Application and Send it Keystrokes (Visual Basic)](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-start-an-application-and-send-it-keystrokes.md)| +|Start an application and send it keystrokes|[How to: Start an Application and Send it Keystrokes (Visual Basic)](how-to-start-an-application-and-send-it-keystrokes.md)| ## See also diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-create-a-registry-key-and-set-its-value.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-create-a-registry-key-and-set-its-value.md index 262ee1940e3fd..9dded6b193ffd 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-create-a-registry-key-and-set-its-value.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-create-a-registry-key-and-set-its-value.md @@ -73,5 +73,5 @@ To run this process, your assembly requires a privilege level granted by the - - -- [Reading from and Writing to the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) +- [Reading from and Writing to the Registry](reading-from-and-writing-to-the-registry.md) - [Code Access Security Basics](../../../../framework/misc/code-access-security-basics.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-delete-a-registry-key.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-delete-a-registry-key.md index f3698b63ee310..b4306dad6d801 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-delete-a-registry-key.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-delete-a-registry-key.md @@ -46,5 +46,5 @@ The and - -- [Security and the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/security-and-the-registry.md) -- [Reading from and Writing to the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) +- [Security and the Registry](security-and-the-registry.md) +- [Reading from and Writing to the Registry](reading-from-and-writing-to-the-registry.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md index da84ba92ae652..dc74f947f9253 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md @@ -43,16 +43,16 @@ This topic describes how to use `My.Computer.Ports` to dial a modem in Visual Ba ## Robust Programming - This example assumes the modem is connected to COM1. We recommend that your code allow the user to select the desired serial port from a list of available ports. For more information, see [How to: Show Available Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md). + This example assumes the modem is connected to COM1. We recommend that your code allow the user to select the desired serial port from a list of available ports. For more information, see [How to: Show Available Serial Ports](how-to-show-available-serial-ports.md). - This example uses a `Using` block to make sure that the application closes the port even if it throws an exception. For more information, see [Using Statement](../../../../visual-basic/language-reference/statements/using-statement.md). + This example uses a `Using` block to make sure that the application closes the port even if it throws an exception. For more information, see [Using Statement](../../../language-reference/statements/using-statement.md). - In this example, the application disconnects the serial port after it dials the modem. Realistically, you will want to transfer data to and from the modem. For more information, see [How to: Receive Strings From Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md). + In this example, the application disconnects the serial port after it dials the modem. Realistically, you will want to transfer data to and from the modem. For more information, see [How to: Receive Strings From Serial Ports](how-to-receive-strings-from-serial-ports.md). ## See also - - -- [How to: Send Strings to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md) -- [How to: Receive Strings From Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md) -- [How to: Show Available Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md) +- [How to: Send Strings to Serial Ports](how-to-send-strings-to-serial-ports.md) +- [How to: Receive Strings From Serial Ports](how-to-receive-strings-from-serial-ports.md) +- [How to: Show Available Serial Ports](how-to-show-available-serial-ports.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-download-a-file.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-download-a-file.md index 472a470547c7b..20aa7be1f7ea2 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-download-a-file.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-download-a-file.md @@ -53,5 +53,5 @@ The following conditions may cause an exception: - - -- [How to: Upload a File](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-upload-a-file.md) -- [How to: Parse File Paths](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [How to: Upload a File](how-to-upload-a-file.md) +- [How to: Parse File Paths](../drives-directories-files/how-to-parse-file-paths.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-read-a-value-from-a-registry-key.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-read-a-value-from-a-registry-key.md index 1cd9888c46b3e..46a93f4d1e163 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-read-a-value-from-a-registry-key.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-read-a-value-from-a-registry-key.md @@ -53,4 +53,4 @@ The `GetValue` method of the `My.Computer.Registry` object can be used to read v - - -- [Reading from and Writing to the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) +- [Reading from and Writing to the Registry](reading-from-and-writing-to-the-registry.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md index a2e862448265f..018e639f7d754 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md @@ -57,14 +57,14 @@ This topic describes how to use `My.Computer.Ports` to receive strings from the ## Robust Programming - This example assumes the computer is using `COM1`. For more flexibility, the code should allow the user to select the desired serial port from a list of available ports. For more information, see [How to: Show Available Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md). + This example assumes the computer is using `COM1`. For more flexibility, the code should allow the user to select the desired serial port from a list of available ports. For more information, see [How to: Show Available Serial Ports](how-to-show-available-serial-ports.md). - This example uses a `Try...Catch...Finally` block to make sure that the application closes the port and to catch any timeout exceptions. For more information, see [Try...Catch...Finally Statement](../../../../visual-basic/language-reference/statements/try-catch-finally-statement.md). + This example uses a `Try...Catch...Finally` block to make sure that the application closes the port and to catch any timeout exceptions. For more information, see [Try...Catch...Finally Statement](../../../language-reference/statements/try-catch-finally-statement.md). ## See also - - -- [How to: Dial Modems Attached to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md) -- [How to: Send Strings to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md) -- [How to: Show Available Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md) +- [How to: Dial Modems Attached to Serial Ports](how-to-dial-modems-attached-to-serial-ports.md) +- [How to: Send Strings to Serial Ports](how-to-send-strings-to-serial-ports.md) +- [How to: Show Available Serial Ports](how-to-show-available-serial-ports.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md index 5ea6e848d720a..0b3f776388043 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md @@ -30,13 +30,13 @@ This topic describes how to use `My.Computer.Ports` to send strings to the compu ## Robust Programming - This example assumes the computer is using `COM1`; for more flexibility, the code should allow the user to select the desired serial port from a list of available ports. For more information, see [How to: Show Available Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md). + This example assumes the computer is using `COM1`; for more flexibility, the code should allow the user to select the desired serial port from a list of available ports. For more information, see [How to: Show Available Serial Ports](how-to-show-available-serial-ports.md). - This example uses a `Using` block to make sure that the application closes the port even if it throws an exception. For more information, see [Using Statement](../../../../visual-basic/language-reference/statements/using-statement.md). + This example uses a `Using` block to make sure that the application closes the port even if it throws an exception. For more information, see [Using Statement](../../../language-reference/statements/using-statement.md). ## See also - - -- [How to: Dial Modems Attached to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md) -- [How to: Show Available Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md) +- [How to: Dial Modems Attached to Serial Ports](how-to-dial-modems-attached-to-serial-ports.md) +- [How to: Show Available Serial Ports](how-to-show-available-serial-ports.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md index 6462ac2fad703..7e072ef46c0ab 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-show-available-serial-ports.md @@ -30,7 +30,7 @@ This topic describes how to use `My.Computer.Ports` to show the available serial - A project reference to System.Windows.Forms.dll. -- Access to the members of the namespace. Add an `Imports` statement if you are not fully qualifying member names in your code. For more information, see [Imports Statement (.NET Namespace and Type)](../../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md). +- Access to the members of the namespace. Add an `Imports` statement if you are not fully qualifying member names in your code. For more information, see [Imports Statement (.NET Namespace and Type)](../../../language-reference/statements/imports-statement-net-namespace-and-type.md). - That your form have a control named `ListBox1`. @@ -44,6 +44,6 @@ This topic describes how to use `My.Computer.Ports` to show the available serial ## See also - -- [How to: Dial Modems Attached to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-dial-modems-attached-to-serial-ports.md) -- [How to: Send Strings to Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-send-strings-to-serial-ports.md) -- [How to: Receive Strings From Serial Ports](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-receive-strings-from-serial-ports.md) +- [How to: Dial Modems Attached to Serial Ports](how-to-dial-modems-attached-to-serial-ports.md) +- [How to: Send Strings to Serial Ports](how-to-send-strings-to-serial-ports.md) +- [How to: Receive Strings From Serial Ports](how-to-receive-strings-from-serial-ports.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-upload-a-file.md b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-upload-a-file.md index 51706c7555ed3..dade934f176ed 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/how-to-upload-a-file.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/how-to-upload-a-file.md @@ -45,5 +45,5 @@ The method can be use - - -- [How to: Download a File](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-download-a-file.md) -- [How to: Parse File Paths](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [How to: Download a File](how-to-download-a-file.md) +- [How to: Parse File Paths](../drives-directories-files/how-to-parse-file-paths.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/index.md b/docs/visual-basic/developing-apps/programming/computer-resources/index.md index 5442ea601f35c..19677a7042532 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/index.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/index.md @@ -25,26 +25,26 @@ The `My.Computer` object is one of the three central objects in `My`, providing ## In this section -[Playing Sounds](../../../../visual-basic/developing-apps/programming/computer-resources/playing-sounds.md) +[Playing Sounds](playing-sounds.md) Lists tasks associated with `My.Computer.Audio`, such as playing a sound in the background. -[Storing Data to and Reading from the Clipboard](../../../../visual-basic/developing-apps/programming/computer-resources/storing-data-to-and-reading-from-the-clipboard.md) +[Storing Data to and Reading from the Clipboard](storing-data-to-and-reading-from-the-clipboard.md) Lists tasks associated with `My.Computer.Clipboard`, such as reading data from or writing data to the Clipboard. -[Getting Information about the Computer](../../../../visual-basic/developing-apps/programming/computer-resources/getting-information-about-the-computer.md) +[Getting Information about the Computer](getting-information-about-the-computer.md) Lists tasks associated with `My.Computer.Info`, such as determining a computer's full name or IP addresses. -[Accessing the Keyboard](../../../../visual-basic/developing-apps/programming/computer-resources/accessing-the-keyboard.md) +[Accessing the Keyboard](accessing-the-keyboard.md) Lists tasks associated with `My.Computer.Keyboard`, such as determining whether CAPS LOCK is on. -[Accessing the Mouse](../../../../visual-basic/developing-apps/programming/computer-resources/accessing-the-mouse.md) +[Accessing the Mouse](accessing-the-mouse.md) Lists tasks associated with `My.Computer.Mouse`, such as determining whether a mouse is present. -[Performing Network Operations](../../../../visual-basic/developing-apps/programming/computer-resources/performing-network-operations.md) +[Performing Network Operations](performing-network-operations.md) Lists tasks associated with `My.Computer.Network`, such as uploading or downloading files. -[Accessing the Computer's Ports](../../../../visual-basic/developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md) +[Accessing the Computer's Ports](accessing-the-computer-s-ports.md) Lists tasks associated with `My.Computer.Ports`, such as showing available serial ports or sending strings to serial ports. -[Reading from and Writing to the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) +[Reading from and Writing to the Registry](reading-from-and-writing-to-the-registry.md) Lists tasks associated with `My.Computer.Registry`, such as reading data from or writing data to registry keys. diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/performing-network-operations.md b/docs/visual-basic/developing-apps/programming/computer-resources/performing-network-operations.md index eb4a2dad304b4..b921f498bc340 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/performing-network-operations.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/performing-network-operations.md @@ -12,13 +12,13 @@ The following tables list tasks associated with the `My.Computer.Network` object ## In This Section - [How to: Upload a File](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-upload-a-file.md) + [How to: Upload a File](how-to-upload-a-file.md) Demonstrates how to upload a file and store it to a remote location using `My.Computer.Network`. - [How to: Download a File](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-download-a-file.md) + [How to: Download a File](how-to-download-a-file.md) Demonstrates how to download a file from a remote location using `My.Computer.Network`. - [How to: Check Connection Status](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-check-connection-status.md) + [How to: Check Connection Status](how-to-check-connection-status.md) Shows how to determine whether the computer has a working network connection. ## Reference diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/port-operations-in-the-net-framework.md b/docs/visual-basic/developing-apps/programming/computer-resources/port-operations-in-the-net-framework.md index b59310990f8f3..b981a0831e23e 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/port-operations-in-the-net-framework.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/port-operations-in-the-net-framework.md @@ -30,4 +30,4 @@ This table lists and describes the main enumerations used for accessing a serial ## See also - -- [Accessing the Computer's Ports](../../../../visual-basic/developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md) +- [Accessing the Computer's Ports](accessing-the-computer-s-ports.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry-using-the-microsoft-win32-namespace.md b/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry-using-the-microsoft-win32-namespace.md index 86cad45e104f6..8eb180bad0554 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry-using-the-microsoft-win32-namespace.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry-using-the-microsoft-win32-namespace.md @@ -41,6 +41,6 @@ Although `My.Computer.Registry` should cover your basic needs when programming a - - - -- [Try...Catch...Finally Statement](../../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) -- [Reading from and Writing to the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) -- [Security and the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/security-and-the-registry.md) +- [Try...Catch...Finally Statement](../../../language-reference/statements/try-catch-finally-statement.md) +- [Reading from and Writing to the Registry](reading-from-and-writing-to-the-registry.md) +- [Security and the Registry](security-and-the-registry.md) diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md b/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md index 70250f0ceec91..b0614a31fc116 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md @@ -15,19 +15,19 @@ This topic describes task and conceptual topics that are associated with the reg ## In This Section - [How to: Create a Registry Key and Set Its Value](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-create-a-registry-key-and-set-its-value.md) + [How to: Create a Registry Key and Set Its Value](how-to-create-a-registry-key-and-set-its-value.md) Describes how to use the `CreateSubKey` and `SetValue` methods of the `My.Computer.Registry` object to create a registry key and set its value. - [How to: Read a Value from a Registry Key](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-read-a-value-from-a-registry-key.md) + [How to: Read a Value from a Registry Key](how-to-read-a-value-from-a-registry-key.md) Describes how to use the `GetValue` method of the `My.Computer.Registry` object to read a value from a registry key. - [How to: Delete a Registry Key](../../../../visual-basic/developing-apps/programming/computer-resources/how-to-delete-a-registry-key.md) + [How to: Delete a Registry Key](how-to-delete-a-registry-key.md) Describes how to use the `DeleteSubKey` method of the `My.Computer.Registry.CurrentUser` property to delete a registry key. - [Reading from and Writing to the Registry Using the Microsoft.Win32 Namespace](../../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry-using-the-microsoft-win32-namespace.md) + [Reading from and Writing to the Registry Using the Microsoft.Win32 Namespace](reading-from-and-writing-to-the-registry-using-the-microsoft-win32-namespace.md) Describes how to use the `Registry` and `RegistryKey` classes of the .NET Framework to access the registry. - [Security and the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/security-and-the-registry.md) + [Security and the Registry](security-and-the-registry.md) Discusses security issues involving the registry. ## Related Sections diff --git a/docs/visual-basic/developing-apps/programming/computer-resources/security-and-the-registry.md b/docs/visual-basic/developing-apps/programming/computer-resources/security-and-the-registry.md index 4d3ea4f92da7d..c531420e47810 100644 --- a/docs/visual-basic/developing-apps/programming/computer-resources/security-and-the-registry.md +++ b/docs/visual-basic/developing-apps/programming/computer-resources/security-and-the-registry.md @@ -38,4 +38,4 @@ This page discusses the security implications of storing data in the registry. ## See also - -- [Reading from and Writing to the Registry](../../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) +- [Reading from and Writing to the Registry](reading-from-and-writing-to-the-registry.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md index 188a9e0f08dce..ae4983fb1f439 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md @@ -15,7 +15,7 @@ ms.assetid: 49d837c0-cf28-416f-8606-4d83d7b479ef Classes in the namespace are used to work with drives, files, and directories. -The namespace contains the and classes, which provide the .NET Framework functionality that manipulates files and directories. Because the methods of these objects are static or shared members, you can use them directly without creating an instance of the class first. Associated with these classes are the and classes, which will be familiar to users of the `My` feature. To use these classes, you must fully qualify the names or import the appropriate namespaces by including the `Imports` statement(s) at the beginning of the affected code. For more information, see [Imports Statement (.NET Namespace and Type)](../../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md). +The namespace contains the and classes, which provide the .NET Framework functionality that manipulates files and directories. Because the methods of these objects are static or shared members, you can use them directly without creating an instance of the class first. Associated with these classes are the and classes, which will be familiar to users of the `My` feature. To use these classes, you must fully qualify the names or import the appropriate namespaces by including the `Imports` statement(s) at the beginning of the affected code. For more information, see [Imports Statement (.NET Namespace and Type)](../../../language-reference/statements/imports-statement-net-namespace-and-type.md). > [!NOTE] > Other topics in this section use the `My.Computer.FileSystem` object instead of `System.IO` classes to work with drives, files, and directories. The `My.Computer.FileSystem` object is intended primarily for use in Visual Basic programs. `System.IO` classes are intended for use by any language that supports the .NET Framework, including Visual Basic. @@ -106,4 +106,4 @@ The component allows you to watch for changes - [Composing Streams](../../../../standard/io/composing-streams.md) - [File and Stream I/O](../../../../standard/io/index.md) - [Asynchronous File I/O](../../../../standard/io/asynchronous-file-i-o.md) -- [Classes Used in .NET Framework File I/O and the File System (Visual Basic)](../../../../visual-basic/developing-apps/programming/drives-directories-files/classes-used-in-net-framework-file-io-and-the-file-system.md) +- [Classes Used in .NET Framework File I/O and the File System (Visual Basic)](classes-used-in-net-framework-file-io-and-the-file-system.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/classes-used-in-net-framework-file-io-and-the-file-system.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/classes-used-in-net-framework-file-io-and-the-file-system.md index 7448c702ab5f7..ac3654984bf1f 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/classes-used-in-net-framework-file-io-and-the-file-system.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/classes-used-in-net-framework-file-io-and-the-file-system.md @@ -59,4 +59,4 @@ For a more comprehensive listing, see [Class Library Overview](../../../../stand - [Composing Streams](../../../../standard/io/composing-streams.md) - [File and Stream I/O](../../../../standard/io/index.md) - [Asynchronous File I/O](../../../../standard/io/asynchronous-file-i-o.md) -- [Basics of .NET Framework File I/O and the File System (Visual Basic)](../../../../visual-basic/developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md) +- [Basics of .NET Framework File I/O and the File System (Visual Basic)](basics-of-net-framework-file-io-and-the-file-system.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md index 98125f976fc9e..ffddf57fb1ab2 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md @@ -29,46 +29,46 @@ This section lists tasks associated with creating, deleting, moving, and renamin ## In This Section - [How to: Copy Files with a Specific Pattern to a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-files-with-a-specific-pattern-to-a-directory.md) + [How to: Copy Files with a Specific Pattern to a Directory](how-to-copy-files-with-a-specific-pattern-to-a-directory.md) Demonstrates how to copy files with a specific file name pattern, such as only .txt files, to a directory. - [How to: Create a Copy of a File in the Same Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-the-same-directory.md) + [How to: Create a Copy of a File in the Same Directory](how-to-create-a-copy-of-a-file-in-the-same-directory.md) Demonstrates how to create a copy of a file in the same directory. - [How to: Create a Copy of a File in a Different Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md) + [How to: Create a Copy of a File in a Different Directory](how-to-create-a-copy-of-a-file-in-a-different-directory.md) Demonstrates how to copy a file to another directory. - [How to: Create a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-file.md) + [How to: Create a File](how-to-create-a-file.md) Demonstrates how to create a file. - [How to: Delete a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-delete-a-file.md) + [How to: Delete a File](how-to-delete-a-file.md) Demonstrates how to delete a file. - [How to: Find Files with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-files-with-a-specific-pattern.md) + [How to: Find Files with a Specific Pattern](how-to-find-files-with-a-specific-pattern.md) Demonstrates how to list only files with a specific file name pattern in a directory. - [How to: Move a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-move-a-file.md) + [How to: Move a File](how-to-move-a-file.md) Demonstrates how to move a file to a different directory. - [How to: Rename a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md) + [How to: Rename a File](how-to-rename-a-file.md) Demonstrates how to rename a file. - [How to: Copy a Directory to Another Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-a-directory-to-another-directory.md) + [How to: Copy a Directory to Another Directory](how-to-copy-a-directory-to-another-directory.md) Demonstrates how to copy a directory to another location. - [How to: Create a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-directory.md) + [How to: Create a Directory](how-to-create-a-directory.md) Demonstrates how to create a directory. - [How to: Find Subdirectories with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md) + [How to: Find Subdirectories with a Specific Pattern](how-to-find-subdirectories-with-a-specific-pattern.md) Demonstrates how to list directories with a specific pattern in their name. - [How to: Get the Collection of Files in a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md) + [How to: Get the Collection of Files in a Directory](how-to-get-the-collection-of-files-in-a-directory.md) Demonstrates how to list the files in a directory. - [How to: Retrieve the Contents of the My Documents Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-retrieve-the-contents-of-the-my-documents-directory.md) + [How to: Retrieve the Contents of the My Documents Directory](how-to-retrieve-the-contents-of-the-my-documents-directory.md) Demonstrates how to read from special directories. - [How to: Parse File Paths](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) + [How to: Parse File Paths](how-to-parse-file-paths.md) Demonstrates how to use `My` methods to combine file paths. ## Reference @@ -114,8 +114,8 @@ This section lists tasks associated with creating, deleting, moving, and renamin ## Related Sections - [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) + [Reading from Files](reading-from-files.md) Lists tasks associated with reading from files. - [Writing to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) + [Writing to Files](writing-to-files.md) Lists tasks involving writing to files. diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/file-access.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/file-access.md index d911fd9cf4b73..0bf2e8d138da8 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/file-access.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/file-access.md @@ -21,23 +21,23 @@ The `My.Computer.FileSystem` object provides tools for working with files and fo ## In This Section - [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) + [Reading from Files](reading-from-files.md) Lists topics dealing with using the `My.Computer.FileSystem` object to read from files - [Writing to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) + [Writing to Files](writing-to-files.md) Lists topics dealing with using the `My.Computer.FileSystem` object to write to files - [Creating, Deleting, and Moving Files and Directories](../../../../visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md) + [Creating, Deleting, and Moving Files and Directories](creating-deleting-and-moving-files-and-directories.md) Lists topics dealing with using the `My.Computer.FileSystem` object to creating, copying, deleting and moving files and folders. - [Parsing Text Files with the TextFieldParser Object](../../../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) + [Parsing Text Files with the TextFieldParser Object](parsing-text-files-with-the-textfieldparser-object.md) Discusses how to use the `TextFieldReader` to parse text files such as logs. - [File Encodings](../../../../visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md) + [File Encodings](file-encodings.md) Describes file encodings and their use. - [Walkthrough: Manipulating Files and Directories in Visual Basic](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md) + [Walkthrough: Manipulating Files and Directories in Visual Basic](walkthrough-manipulating-files-and-directories.md) Demonstrates how to create a utility that reports information about files and folders. - [Troubleshooting: Reading from and Writing to Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) + [Troubleshooting: Reading from and Writing to Text Files](troubleshooting-reading-from-and-writing-to-text-files.md) Lists common problems encountered when reading and writing to text files, and suggests remedies for each. diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md index 79d813060c3de..27da31de77453 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md @@ -34,5 +34,5 @@ The class represents a character encoding. This tabl ## See also -- [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) -- [Writing to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) +- [Reading from Files](reading-from-files.md) +- [Writing to Files](writing-to-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-append-to-text-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-append-to-text-files.md index 2a6f752099634..43e30a5ec1b55 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-append-to-text-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-append-to-text-files.md @@ -41,4 +41,4 @@ The method can be - - -- [Writing to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) +- [Writing to Files](writing-to-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-a-directory-to-another-directory.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-a-directory-to-another-directory.md index 5e3fd2d91cff6..ac619ea39ee5c 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-a-directory-to-another-directory.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-a-directory-to-another-directory.md @@ -59,5 +59,5 @@ The following conditions may cause an exception: ## See also - -- [How to: Find Subdirectories with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md) -- [How to: Get the Collection of Files in a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md) +- [How to: Find Subdirectories with a Specific Pattern](how-to-find-subdirectories-with-a-specific-pattern.md) +- [How to: Get the Collection of Files in a Directory](how-to-get-the-collection-of-files-in-a-directory.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-files-with-a-specific-pattern-to-a-directory.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-files-with-a-specific-pattern-to-a-directory.md index 57221b55d650b..1634b34d3143c 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-files-with-a-specific-pattern-to-a-directory.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-files-with-a-specific-pattern-to-a-directory.md @@ -58,6 +58,6 @@ The method r - - -- [How to: Find Subdirectories with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md) -- [Troubleshooting: Reading from and Writing to Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) -- [How to: Get the Collection of Files in a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md) +- [How to: Find Subdirectories with a Specific Pattern](how-to-find-subdirectories-with-a-specific-pattern.md) +- [Troubleshooting: Reading from and Writing to Text Files](troubleshooting-reading-from-and-writing-to-text-files.md) +- [How to: Get the Collection of Files in a Directory](how-to-get-the-collection-of-files-in-a-directory.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md index 8de7eaefdec1b..937af6bc18696 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md @@ -55,7 +55,7 @@ The `My.Computer.FileSystem.CopyFile` method allows you to copy files. Its param - - - -- [How to: Copy Files with a Specific Pattern to a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-files-with-a-specific-pattern-to-a-directory.md) -- [How to: Create a Copy of a File in the Same Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-the-same-directory.md) -- [How to: Copy a Directory to Another Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-a-directory-to-another-directory.md) -- [How to: Rename a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md) +- [How to: Copy Files with a Specific Pattern to a Directory](how-to-copy-files-with-a-specific-pattern-to-a-directory.md) +- [How to: Create a Copy of a File in the Same Directory](how-to-create-a-copy-of-a-file-in-the-same-directory.md) +- [How to: Copy a Directory to Another Directory](how-to-copy-a-directory-to-another-directory.md) +- [How to: Rename a File](how-to-rename-a-file.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-the-same-directory.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-the-same-directory.md index a669f85484587..796ee01862473 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-the-same-directory.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-the-same-directory.md @@ -63,7 +63,7 @@ Use the `My.Computer.FileSystem.CopyFile` method to copy files. The parameters a - - - -- [How to: Copy Files with a Specific Pattern to a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-files-with-a-specific-pattern-to-a-directory.md) -- [How to: Create a Copy of a File in a Different Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md) -- [How to: Copy a Directory to Another Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-copy-a-directory-to-another-directory.md) -- [How to: Rename a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md) +- [How to: Copy Files with a Specific Pattern to a Directory](how-to-copy-files-with-a-specific-pattern-to-a-directory.md) +- [How to: Create a Copy of a File in a Different Directory](how-to-create-a-copy-of-a-file-in-a-different-directory.md) +- [How to: Copy a Directory to Another Directory](how-to-copy-a-directory-to-another-directory.md) +- [How to: Rename a File](how-to-rename-a-file.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-directory.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-directory.md index 7a0703dad22f3..0f0c0ebfd4516 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-directory.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-directory.md @@ -39,4 +39,4 @@ Use the `CreateDirectory` method of the `My.Computer.FileSystem` object to creat ## See also - -- [Creating, Deleting, and Moving Files and Directories](../../../../visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md) +- [Creating, Deleting, and Moving Files and Directories](creating-deleting-and-moving-files-and-directories.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-delete-a-file.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-delete-a-file.md index 2625af829a40c..db328ffe482f2 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-delete-a-file.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-delete-a-file.md @@ -60,4 +60,4 @@ The `DeleteFile` method of the `My.Computer.FileSystem` object allows you to del - - - -- [How to: Get the Collection of Files in a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md) +- [How to: Get the Collection of Files in a Directory](how-to-get-the-collection-of-files-in-a-directory.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-files-with-a-specific-pattern.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-files-with-a-specific-pattern.md index d2fc8e56cbbdd..e0f97168c67c7 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-files-with-a-specific-pattern.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-files-with-a-specific-pattern.md @@ -45,6 +45,6 @@ The method r ## See also - -- [How to: Find Subdirectories with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md) -- [Troubleshooting: Reading from and Writing to Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) -- [How to: Get the Collection of Files in a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md) +- [How to: Find Subdirectories with a Specific Pattern](how-to-find-subdirectories-with-a-specific-pattern.md) +- [Troubleshooting: Reading from and Writing to Text Files](troubleshooting-reading-from-and-writing-to-text-files.md) +- [How to: Get the Collection of Files in a Directory](how-to-get-the-collection-of-files-in-a-directory.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md index a1115c59ee4db..a41a740ea1b4b 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md @@ -43,4 +43,4 @@ The following conditions may cause an exception: ## See also - -- [How to: Find Files with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-files-with-a-specific-pattern.md) +- [How to: Find Files with a Specific Pattern](how-to-find-files-with-a-specific-pattern.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md index 48ee8341af642..12e14a38f6866 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md @@ -45,5 +45,5 @@ The overloads of the -- [How to: Find Files with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-files-with-a-specific-pattern.md) -- [How to: Find Subdirectories with a Specific Pattern](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-find-subdirectories-with-a-specific-pattern.md) +- [How to: Find Files with a Specific Pattern](how-to-find-files-with-a-specific-pattern.md) +- [How to: Find Subdirectories with a Specific Pattern](how-to-find-subdirectories-with-a-specific-pattern.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-move-a-file.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-move-a-file.md index 5e39f331694ee..5ec487efb7a5b 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-move-a-file.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-move-a-file.md @@ -48,6 +48,6 @@ The `My.Computer.FileSystem.MoveFile` method can be used to move a file to anoth ## See also - -- [How to: Rename a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md) -- [How to: Create a Copy of a File in a Different Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md) -- [How to: Parse File Paths](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [How to: Rename a File](how-to-rename-a-file.md) +- [How to: Create a Copy of a File in a Different Directory](how-to-create-a-copy-of-a-file-in-a-different-directory.md) +- [How to: Parse File Paths](how-to-parse-file-paths.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md index 9bab8036d786b..eb525d3921500 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md @@ -36,4 +36,4 @@ The object offers a number of use - - - -- [How to: Get the Collection of Files in a Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-get-the-collection-of-files-in-a-directory.md) +- [How to: Get the Collection of Files in a Directory](how-to-get-the-collection-of-files-in-a-directory.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-binary-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-binary-files.md index 1a21f035ecd35..14de9e0deba86 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-binary-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-binary-files.md @@ -50,6 +50,6 @@ The `My.Computer.FileSystem` object provides the `ReadAllBytes` method for readi - - -- [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) -- [How to: Read From Text Files with Multiple Formats](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md) -- [Storing Data to and Reading from the Clipboard](../../../../visual-basic/developing-apps/programming/computer-resources/storing-data-to-and-reading-from-the-clipboard.md) +- [Reading from Files](reading-from-files.md) +- [How to: Read From Text Files with Multiple Formats](how-to-read-from-text-files-with-multiple-formats.md) +- [Storing Data to and Reading from the Clipboard](../computer-resources/storing-data-to-and-reading-from-the-clipboard.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md index dea5955d9f091..133e934cbe45e 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md @@ -53,8 +53,8 @@ The `TextFieldParser` object provides a way to easily and efficiently parse stru ## See also - -- [How to: Read From Fixed-width Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md) -- [How to: Read From Text Files with Multiple Formats](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md) -- [Parsing Text Files with the TextFieldParser Object](../../../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) -- [Walkthrough: Manipulating Files and Directories in Visual Basic](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md) -- [Troubleshooting: Reading from and Writing to Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) +- [How to: Read From Fixed-width Text Files](how-to-read-from-fixed-width-text-files.md) +- [How to: Read From Text Files with Multiple Formats](how-to-read-from-text-files-with-multiple-formats.md) +- [Parsing Text Files with the TextFieldParser Object](parsing-text-files-with-the-textfieldparser-object.md) +- [Walkthrough: Manipulating Files and Directories in Visual Basic](walkthrough-manipulating-files-and-directories.md) +- [Troubleshooting: Reading from and Writing to Text Files](troubleshooting-reading-from-and-writing-to-text-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md index 3012fc2d1298c..0afec4a95ef98 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md @@ -56,8 +56,8 @@ The `TextFieldParser` object provides a way to easily and efficiently parse stru ## See also - -- [How to: Read From Comma-Delimited Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md) -- [How to: Read From Text Files with Multiple Formats](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md) -- [Parsing Text Files with the TextFieldParser Object](../../../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) -- [Walkthrough: Manipulating Files and Directories in Visual Basic](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md) -- [Troubleshooting: Reading from and Writing to Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) +- [How to: Read From Comma-Delimited Text Files](how-to-read-from-comma-delimited-text-files.md) +- [How to: Read From Text Files with Multiple Formats](how-to-read-from-text-files-with-multiple-formats.md) +- [Parsing Text Files with the TextFieldParser Object](parsing-text-files-with-the-textfieldparser-object.md) +- [Walkthrough: Manipulating Files and Directories in Visual Basic](walkthrough-manipulating-files-and-directories.md) +- [Troubleshooting: Reading from and Writing to Text Files](troubleshooting-reading-from-and-writing-to-text-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files.md index 385cc492a5b3b..b6b9971b7ca9b 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files.md @@ -58,10 +58,10 @@ Verify all inputs before using the data in your application. The contents of the - - -- [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) -- [How to: Read From Comma-Delimited Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md) -- [How to: Read From Fixed-width Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md) -- [How to: Read From Text Files with Multiple Formats](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md) -- [Troubleshooting: Reading from and Writing to Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) -- [Walkthrough: Manipulating Files and Directories in Visual Basic](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md) -- [File Encodings](../../../../visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md) +- [Reading from Files](reading-from-files.md) +- [How to: Read From Comma-Delimited Text Files](how-to-read-from-comma-delimited-text-files.md) +- [How to: Read From Fixed-width Text Files](how-to-read-from-fixed-width-text-files.md) +- [How to: Read From Text Files with Multiple Formats](how-to-read-from-text-files-with-multiple-formats.md) +- [Troubleshooting: Reading from and Writing to Text Files](troubleshooting-reading-from-and-writing-to-text-files.md) +- [Walkthrough: Manipulating Files and Directories in Visual Basic](walkthrough-manipulating-files-and-directories.md) +- [File Encodings](file-encodings.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-text-from-files-with-a-streamreader.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-text-from-files-with-a-streamreader.md index df5fe56cc9d02..7713e0f68c836 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-text-from-files-with-a-streamreader.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-read-text-from-files-with-a-streamreader.md @@ -37,4 +37,4 @@ The `My.Computer.FileSystem` object provides methods to open a - - [SaveFileDialog Component](../../../../framework/winforms/controls/savefiledialog-component-windows-forms.md) -- [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) +- [Reading from Files](reading-from-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md index 7083475f30a95..6e1845b28a0aa 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md @@ -45,7 +45,7 @@ Use the `RenameFile` method of the `My.Computer.FileSystem` object to rename a f ## See also - -- [How to: Move a File](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-move-a-file.md) -- [Creating, Deleting, and Moving Files and Directories](../../../../visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md) -- [How to: Create a Copy of a File in the Same Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-the-same-directory.md) -- [How to: Create a Copy of a File in a Different Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-create-a-copy-of-a-file-in-a-different-directory.md) +- [How to: Move a File](how-to-move-a-file.md) +- [Creating, Deleting, and Moving Files and Directories](creating-deleting-and-moving-files-and-directories.md) +- [How to: Create a Copy of a File in the Same Directory](how-to-create-a-copy-of-a-file-in-the-same-directory.md) +- [How to: Create a Copy of a File in a Different Directory](how-to-create-a-copy-of-a-file-in-a-different-directory.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files-with-a-streamwriter.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files-with-a-streamwriter.md index a31b5f45d03e1..7e8b6a9327f4a 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files-with-a-streamwriter.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files-with-a-streamwriter.md @@ -33,5 +33,5 @@ This example opens a object with the `My.Computer. - - -- [How to: Read from Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files.md) -- [Writing to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) +- [How to: Read from Text Files](how-to-read-from-text-files.md) +- [Writing to Files](writing-to-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files.md index 9e25d5b88421c..da07430108d84 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files.md @@ -54,4 +54,4 @@ The method can be - - -- [How to: Read from Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files.md) +- [How to: Read from Text Files](how-to-read-from-text-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-to-binary-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-to-binary-files.md index cdd454313b027..80689efaeb516 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-to-binary-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/how-to-write-to-binary-files.md @@ -40,4 +40,4 @@ The following conditions may create an exception: ## See also - -- [How to: Write Text to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files.md) +- [How to: Write Text to Files](how-to-write-text-to-files.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/index.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/index.md index fb7587173da5b..d797aa4a5933c 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/index.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/index.md @@ -16,21 +16,21 @@ You can use Visual Basic to process drives, folders, and files with the `My.Comp ## In This Section - [File Access with Visual Basic](../../../../visual-basic/developing-apps/programming/drives-directories-files/file-access.md) + [File Access with Visual Basic](file-access.md) Discusses how to use the `My.Computer.FileSystem` object to work with files, drives, and folders. - [Basics of .NET Framework File I/O and the File System (Visual Basic)](../../../../visual-basic/developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md) + [Basics of .NET Framework File I/O and the File System (Visual Basic)](basics-of-net-framework-file-io-and-the-file-system.md) Provides an overview of file I/O concepts in the .NET Framework, including streams, isolated storage, file events, file attributes, and file access. - [Walkthrough: Manipulating Files by Using .NET Framework Methods](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-by-using-net-framework-methods.md) + [Walkthrough: Manipulating Files by Using .NET Framework Methods](walkthrough-manipulating-files-by-using-net-framework-methods.md) Demonstrates how to use the .NET Framework to manipulate files and folders. - [Walkthrough: Manipulating Files and Directories in Visual Basic](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md) + [Walkthrough: Manipulating Files and Directories in Visual Basic](walkthrough-manipulating-files-and-directories.md) Demonstrates how to use the `My.Computer.FileSystem` object to manipulate files and folders. ## Related Sections - [Program Structure and Code Conventions](../../../../visual-basic/programming-guide/program-structure/program-structure-and-code-conventions.md) + [Program Structure and Code Conventions](../../../programming-guide/program-structure/program-structure-and-code-conventions.md) Provides guidelines for the physical structure and appearance of programs. diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md index 5733263f70870..1d9b3be4e7c10 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md @@ -27,7 +27,7 @@ The `TextFieldParser` object allows you to parse and process very large file tha ## Parsing files with multiple formats - The `PeekChars` method of the `TextFieldParser` object can be used to check each field before reading it, allowing you to define multiple formats for the fields and react accordingly. For more information, see [How to: Read From Text Files with Multiple Formats](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md). + The `PeekChars` method of the `TextFieldParser` object can be used to check each field before reading it, allowing you to define multiple formats for the fields and react accordingly. For more information, see [How to: Read From Text Files with Multiple Formats](how-to-read-from-text-files-with-multiple-formats.md). ## See also diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md index f04983cf55cc6..9ba9f25a86a67 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md @@ -15,22 +15,22 @@ This section explains how to perform tasks that are associated with reading from ## In This Section - [How to: Read from Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files.md) + [How to: Read from Text Files](how-to-read-from-text-files.md) Demonstrates how to read from a text file. - [How to: Read From Comma-Delimited Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md) + [How to: Read From Comma-Delimited Text Files](how-to-read-from-comma-delimited-text-files.md) Demonstrates how to read from a delimited text file. - [How to: Read From Fixed-width Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md) + [How to: Read From Fixed-width Text Files](how-to-read-from-fixed-width-text-files.md) Demonstrates how to read from a fixed-width text file. - [How to: Read From Text Files with Multiple Formats](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md) + [How to: Read From Text Files with Multiple Formats](how-to-read-from-text-files-with-multiple-formats.md) Demonstrates how to read from a text file with multiple formats. - [How to: Read From Binary Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-binary-files.md) + [How to: Read From Binary Files](how-to-read-from-binary-files.md) Demonstrates how to read from a binary file. - [How to: Read Text from Files with a StreamReader](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-text-from-files-with-a-streamreader.md) + [How to: Read Text from Files with a StreamReader](how-to-read-text-from-files-with-a-streamreader.md) Demonstrates how to use a to read from a file. ## Reference @@ -52,14 +52,14 @@ This section explains how to perform tasks that are associated with reading from ## Related Sections - [Storing Data to and Reading from the Clipboard](../../../../visual-basic/developing-apps/programming/computer-resources/storing-data-to-and-reading-from-the-clipboard.md) + [Storing Data to and Reading from the Clipboard](../computer-resources/storing-data-to-and-reading-from-the-clipboard.md) Explains how to perform tasks that are associated with `My.Computer.Clipboard`, such as reading data from or writing data to the Clipboard. - [Parsing Text Files with the TextFieldParser Object](../../../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) + [Parsing Text Files with the TextFieldParser Object](parsing-text-files-with-the-textfieldparser-object.md) Provides an overview of reading text files with the `TextFieldParser` object. - [Walkthrough: Manipulating Files and Directories in Visual Basic](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md) + [Walkthrough: Manipulating Files and Directories in Visual Basic](walkthrough-manipulating-files-and-directories.md) Demonstrates how to use the `My` feature with files and directories. - [Walkthrough: Manipulating Files by Using .NET Framework Methods](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-by-using-net-framework-methods.md) + [Walkthrough: Manipulating Files by Using .NET Framework Methods](walkthrough-manipulating-files-by-using-net-framework-methods.md) Demonstrates how to use .NET Framework methods with files and directories. diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md index 709030bd08aa9..65fa242889c92 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md @@ -24,15 +24,15 @@ This topic discusses common problems encountered when working with text files an ### File encodings - File encodings, also known as character encodings, specify how to represent characters when text processing. Unexpected characters in a text file may result from incorrect encoding. For most files, one encoding may be preferable over another in terms of which language characters it can or cannot handle, although Unicode is usually preferred. For more information, see [File Encodings](../../../../visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md) and . + File encodings, also known as character encodings, specify how to represent characters when text processing. Unexpected characters in a text file may result from incorrect encoding. For most files, one encoding may be preferable over another in terms of which language characters it can or cannot handle, although Unicode is usually preferred. For more information, see [File Encodings](file-encodings.md) and . ### Incorrect paths - When parsing file paths, particularly relative paths, it is easy to supply the wrong data. Many problems can be corrected by making sure you are supplying the correct path. For more information, see [How to: Parse File Paths](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md). + When parsing file paths, particularly relative paths, it is easy to supply the wrong data. Many problems can be corrected by making sure you are supplying the correct path. For more information, see [How to: Parse File Paths](how-to-parse-file-paths.md). ## See also - -- [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) -- [Writing to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) -- [Parsing Text Files with the TextFieldParser Object](../../../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) +- [Reading from Files](reading-from-files.md) +- [Writing to Files](writing-to-files.md) +- [Parsing Text Files with the TextFieldParser Object](parsing-text-files-with-the-textfieldparser-object.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md index 8c98f6475f724..13f9b3fa93041 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-and-directories.md @@ -161,4 +161,4 @@ This walkthrough provides an introduction to the fundamentals of file I/O in Vis - - - -- [Walkthrough: Manipulating Files by Using .NET Framework Methods](../../../../visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-by-using-net-framework-methods.md) +- [Walkthrough: Manipulating Files by Using .NET Framework Methods](walkthrough-manipulating-files-by-using-net-framework-methods.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-by-using-net-framework-methods.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-by-using-net-framework-methods.md index 58d265443650a..29f9c675440c0 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-by-using-net-framework-methods.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/walkthrough-manipulating-files-by-using-net-framework-methods.md @@ -150,4 +150,4 @@ To test your code, press F5 to compile the application. Click **Get Entries**, s - - -- [Walkthroughs](../../../../visual-basic/walkthroughs.md) +- [Walkthroughs](../../../walkthroughs.md) diff --git a/docs/visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md b/docs/visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md index 8741403c2348c..dacc8ed675656 100644 --- a/docs/visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md +++ b/docs/visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md @@ -15,19 +15,19 @@ This section explains how to perform tasks that involve writing to files. ## In This Section - [How to: Write Text to Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files.md) + [How to: Write Text to Files](how-to-write-text-to-files.md) Demonstrates how to write to text files. - [How to: Append to Text Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-append-to-text-files.md) + [How to: Append to Text Files](how-to-append-to-text-files.md) Demonstrates how to append text to a text file. - [How to: Write to Binary Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-write-to-binary-files.md) + [How to: Write to Binary Files](how-to-write-to-binary-files.md) Demonstrates how to write to a binary file. - [How to: Write Text to Files in the My Documents Directory](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files-in-the-my-documents-directory.md) + [How to: Write Text to Files in the My Documents Directory](how-to-write-text-to-files-in-the-my-documents-directory.md) Demonstrates how to create and write to a new text file in the **My Documents** directory. - [How to: Write Text to Files with a StreamWriter](../../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-write-text-to-files-with-a-streamwriter.md) + [How to: Write Text to Files with a StreamWriter](how-to-write-text-to-files-with-a-streamwriter.md) Demonstrates how to write to a file with a object. ## Reference @@ -46,14 +46,14 @@ This section explains how to perform tasks that involve writing to files. ## Related Sections - [Reading from Files](../../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) + [Reading from Files](reading-from-files.md) Explains how to perform tasks that involve reading from files. - [Creating, Deleting, and Moving Files and Directories](../../../../visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md) + [Creating, Deleting, and Moving Files and Directories](creating-deleting-and-moving-files-and-directories.md) Explains how to perform tasks that involve creating, deleting, moving, and renaming files and directories. - [Storing Data to and Reading from the Clipboard](../../../../visual-basic/developing-apps/programming/computer-resources/storing-data-to-and-reading-from-the-clipboard.md) + [Storing Data to and Reading from the Clipboard](../computer-resources/storing-data-to-and-reading-from-the-clipboard.md) Explains how to perform tasks that are associated with `My.Computer.Clipboard`, such as reading data from or writing data to the Clipboard. - [File Encodings](../../../../visual-basic/developing-apps/programming/drives-directories-files/file-encodings.md) + [File Encodings](file-encodings.md) Provides an overview of file encodings. diff --git a/docs/visual-basic/developing-apps/programming/index.md b/docs/visual-basic/developing-apps/programming/index.md index f096ca122271e..8fc35b76ad8a7 100644 --- a/docs/visual-basic/developing-apps/programming/index.md +++ b/docs/visual-basic/developing-apps/programming/index.md @@ -12,22 +12,22 @@ This section discusses programming tasks that you may want to learn more about a ## In this section - [Accessing Computer Resources](../../../visual-basic/developing-apps/programming/computer-resources/index.md) + [Accessing Computer Resources](computer-resources/index.md) Contains documentation on how to use the `My.Computer` object to access information about the computer on which an application runs and how to control the computer. - [Logging Information from the Application](../../../visual-basic/developing-apps/programming/log-info/index.md) + [Logging Information from the Application](log-info/index.md) Contains documentation on how to log information from your application using the `My.Application.Log` and `My.Log` objects, and how to extend the application's logging capabilities. - [Accessing User Data](../../../visual-basic/developing-apps/programming/accessing-user-data.md) + [Accessing User Data](accessing-user-data.md) Contains documentation on tasks that you can accomplish using the `My.User` object. - [Accessing Application Forms](../../../visual-basic/developing-apps/programming/accessing-application-forms.md) + [Accessing Application Forms](accessing-application-forms.md) Contains documentation on accessing an application's forms by using the `My.Forms` and `My.Application` objects. - [Accessing Application Web Services](../../../visual-basic/developing-apps/programming/accessing-application-web-services.md) + [Accessing Application Web Services](accessing-application-web-services.md) Contains documentation on how to access the Web services referenced by the application using the `My.WebServices` object. - [Accessing Application Settings](../../../visual-basic/developing-apps/programming/app-settings/index.md) + [Accessing Application Settings](app-settings/index.md) Contains documentation on accessing an application's settings using the `My.Settings` object. [Processing Drives, Directories, and Files](drives-directories-files/index.md) @@ -35,7 +35,7 @@ This section discusses programming tasks that you may want to learn more about a ## See also -- [Visual Basic Language Features](../../../visual-basic/programming-guide/language-features/index.md) -- [Programming Concepts](../../../visual-basic/programming-guide/concepts/index.md) -- [Collections](../../../visual-basic/programming-guide/concepts/collections.md) -- [Developing Applications with Visual Basic](../../../visual-basic/developing-apps/index.md) +- [Visual Basic Language Features](../../programming-guide/language-features/index.md) +- [Programming Concepts](../../programming-guide/concepts/index.md) +- [Collections](../../programming-guide/concepts/collections.md) +- [Developing Applications with Visual Basic](../index.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md b/docs/visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md index 0b7d2fe2a8100..7ff3a7e5713dc 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md +++ b/docs/visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md @@ -65,7 +65,7 @@ You can use the `My.Application.Log` and `My.Log` objects to log information abo - - - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [How to: Write Log Messages](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md) -- [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md) -- [Walkthrough: Changing Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md) +- [Working with Application Logs](working-with-application-logs.md) +- [How to: Write Log Messages](how-to-write-log-messages.md) +- [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md) +- [Walkthrough: Changing Where My.Application.Log Writes Information](walkthrough-changing-where-my-application-log-writes-information.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/how-to-log-messages-when-the-application-starts-or-shuts-down.md b/docs/visual-basic/developing-apps/programming/log-info/how-to-log-messages-when-the-application-starts-or-shuts-down.md index 64544046bf1b0..7fabf39a5a22e 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/how-to-log-messages-when-the-application-starts-or-shuts-down.md +++ b/docs/visual-basic/developing-apps/programming/log-info/how-to-log-messages-when-the-application-starts-or-shuts-down.md @@ -60,4 +60,4 @@ You can use the `My.Application.Log` and `My.Log` objects to log information abo - - - [Application Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/application-page-project-designer-visual-basic) -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) +- [Working with Application Logs](working-with-application-logs.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/how-to-write-event-information-to-a-text-file.md b/docs/visual-basic/developing-apps/programming/log-info/how-to-write-event-information-to-a-text-file.md index aee4096447564..f29b9894f89bb 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/how-to-write-event-information-to-a-text-file.md +++ b/docs/visual-basic/developing-apps/programming/log-info/how-to-write-event-information-to-a-text-file.md @@ -56,7 +56,7 @@ You can use the `My.Application.Log` and `My.Log` objects to log information abo ### To write event information to the file log -Use the `My.Application.Log.WriteEntry` or `My.Application.Log.WriteException` method to write information to the file log. For more information, see [How to: Write Log Messages](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md) and [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md). +Use the `My.Application.Log.WriteEntry` or `My.Application.Log.WriteException` method to write information to the file log. For more information, see [How to: Write Log Messages](how-to-write-log-messages.md) and [How to: Log Exceptions](how-to-log-exceptions.md). After you configure the file log listener for an assembly, it receives all messages that `My.Application.Log` writes from that assembly. @@ -65,5 +65,5 @@ After you configure the file log listener for an assembly, it receives all messa - - - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md) +- [Working with Application Logs](working-with-application-logs.md) +- [How to: Log Exceptions](how-to-log-exceptions.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md b/docs/visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md index 36616e7b124e4..0e0c5da74580d 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md +++ b/docs/visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md @@ -10,7 +10,7 @@ ms.assetid: 972a3e0c-2996-4623-a7a9-d7ebc4d207f8 You can use the `My.Application.Log` and `My.Log` objects to log information about your application. This example shows how to use the `My.Application.Log.WriteEntry` method to log tracing information. -For logging exception information, use the `My.Application.Log.WriteException` method; see [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md). +For logging exception information, use the `My.Application.Log.WriteException` method; see [How to: Log Exceptions](how-to-log-exceptions.md). ## Example @@ -20,15 +20,15 @@ This example uses the `My.Application.Log.WriteEntry` method to write out the tr ## .NET Framework Security -Make sure the data you write to the log does not include sensitive information such as user passwords. For more information, see [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md). +Make sure the data you write to the log does not include sensitive information such as user passwords. For more information, see [Working with Application Logs](working-with-application-logs.md). ## See also - - - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md) -- [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md) -- [Walkthrough: Changing Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md) -- [Walkthrough: Filtering My.Application.Log Output](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md) +- [Working with Application Logs](working-with-application-logs.md) +- [How to: Log Exceptions](how-to-log-exceptions.md) +- [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md) +- [Walkthrough: Changing Where My.Application.Log Writes Information](walkthrough-changing-where-my-application-log-writes-information.md) +- [Walkthrough: Filtering My.Application.Log Output](walkthrough-filtering-my-application-log-output.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md b/docs/visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md index aef1eb0f19d27..82fa9c4edef7b 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md +++ b/docs/visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md @@ -54,11 +54,11 @@ To view an event log, you can use **Server Explorer** or **Windows Event Viewer* Replace `APPLICATION_NAME` with the name of your application. > [!NOTE] - > Typically, an application writes only errors to the event log. For information on filtering log output, see [Walkthrough: Filtering My.Application.Log Output](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md). + > Typically, an application writes only errors to the event log. For information on filtering log output, see [Walkthrough: Filtering My.Application.Log Output](walkthrough-filtering-my-application-log-output.md). ## To write event information to the event log -Use the `My.Application.Log.WriteEntry` or `My.Application.Log.WriteException` method to write information to the event log. For more information, see [How to: Write Log Messages](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md) and [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md). +Use the `My.Application.Log.WriteEntry` or `My.Application.Log.WriteException` method to write information to the event log. For more information, see [How to: Write Log Messages](how-to-write-log-messages.md) and [How to: Log Exceptions](how-to-log-exceptions.md). After you configure the event log listener for an assembly, it receives all messages that `My.Application.Log` writes from that assembly. @@ -67,6 +67,6 @@ After you configure the event log listener for an assembly, it receives all mess - - - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md) -- [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md) +- [Working with Application Logs](working-with-application-logs.md) +- [How to: Log Exceptions](how-to-log-exceptions.md) +- [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/index.md b/docs/visual-basic/developing-apps/programming/log-info/index.md index 77d2527b598e8..3373e0e6ad1d2 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/index.md +++ b/docs/visual-basic/developing-apps/programming/log-info/index.md @@ -22,18 +22,18 @@ This section contains topics that cover how to log information from your applica |To|See| |--------|---------| -|Write event information to the application's logs.|[How to: Write Log Messages](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md)| -|Write exception information to the application's logs.|[How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md)| -|Write trace information to the application's logs when the application starts and shuts down.|[How to: Log Messages When the Application Starts or Shuts Down](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-messages-when-the-application-starts-or-shuts-down.md)| -|Configure `My.Application.Log` to write information to a text file.|[How to: Write Event Information to a Text File](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-event-information-to-a-text-file.md)| -|Configure `My.Application.Log` to write information to an event log.|[How to: Write to an Application Event Log](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md)| -|Change where `My.Application.Log` writes information.|[Walkthrough: Changing Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md)| -|Determine where `My.Application.Log` writes information.|[Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md)| -|Create a custom log listener for `My.Application.Log`.|[Walkthrough: Creating Custom Log Listeners](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-creating-custom-log-listeners.md)| -|Filter the output of the `My.Application.Log` logs.|[Walkthrough: Filtering My.Application.Log Output](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md)| +|Write event information to the application's logs.|[How to: Write Log Messages](how-to-write-log-messages.md)| +|Write exception information to the application's logs.|[How to: Log Exceptions](how-to-log-exceptions.md)| +|Write trace information to the application's logs when the application starts and shuts down.|[How to: Log Messages When the Application Starts or Shuts Down](how-to-log-messages-when-the-application-starts-or-shuts-down.md)| +|Configure `My.Application.Log` to write information to a text file.|[How to: Write Event Information to a Text File](how-to-write-event-information-to-a-text-file.md)| +|Configure `My.Application.Log` to write information to an event log.|[How to: Write to an Application Event Log](how-to-write-to-an-application-event-log.md)| +|Change where `My.Application.Log` writes information.|[Walkthrough: Changing Where My.Application.Log Writes Information](walkthrough-changing-where-my-application-log-writes-information.md)| +|Determine where `My.Application.Log` writes information.|[Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md)| +|Create a custom log listener for `My.Application.Log`.|[Walkthrough: Creating Custom Log Listeners](walkthrough-creating-custom-log-listeners.md)| +|Filter the output of the `My.Application.Log` logs.|[Walkthrough: Filtering My.Application.Log Output](walkthrough-filtering-my-application-log-output.md)| ## See also - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [Troubleshooting: Log Listeners](../../../../visual-basic/developing-apps/programming/log-info/troubleshooting-log-listeners.md) +- [Working with Application Logs](working-with-application-logs.md) +- [Troubleshooting: Log Listeners](troubleshooting-log-listeners.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/troubleshooting-log-listeners.md b/docs/visual-basic/developing-apps/programming/log-info/troubleshooting-log-listeners.md index 3cbf2257ed126..4c2e6ce296ca6 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/troubleshooting-log-listeners.md +++ b/docs/visual-basic/developing-apps/programming/log-info/troubleshooting-log-listeners.md @@ -11,15 +11,15 @@ ms.assetid: ac6eb760-3d5d-461e-aedd-40599ee22e49 You can use the `My.Application.Log` and `My.Log` objects to log information about events that occur in your application. - To determine which log listeners receive those messages, see [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md). + To determine which log listeners receive those messages, see [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md). - The `Log` object can use log filtering to limit the amount of information that it logs. If the filters are misconfigured, the logs might contain the wrong information. For more information about filtering, see [Walkthrough: Filtering My.Application.Log Output](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md). + The `Log` object can use log filtering to limit the amount of information that it logs. If the filters are misconfigured, the logs might contain the wrong information. For more information about filtering, see [Walkthrough: Filtering My.Application.Log Output](walkthrough-filtering-my-application-log-output.md). However, if a log is configured incorrectly, you may need more information about its current configuration. You can get to this information through the log's advanced `TraceSource` property. ### To determine the log listeners for the Log object in code -1. Import the namespace at the beginning of the code file. For more information, see [Imports Statement (.NET Namespace and Type)](../../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md). +1. Import the namespace at the beginning of the code file. For more information, see [Imports Statement (.NET Namespace and Type)](../../../language-reference/statements/imports-statement-net-namespace-and-type.md). [!code-vb[VbVbalrMyApplicationLog#13](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMyApplicationLog/VB/Form1.vb#13)] @@ -36,5 +36,5 @@ You can use the `My.Application.Log` and `My.Log` objects to log information abo ## See also - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md) +- [Working with Application Logs](working-with-application-logs.md) +- [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md index b711feb4ba995..971a9533694ca 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md +++ b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md @@ -12,9 +12,9 @@ You can use the `My.Application.Log` and `My.Log` objects to log information abo ## Prerequisites -The `Log` object can write information to several log listeners. You need to determine the current configuration of the log listeners before changing the configurations. For more information, see [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md). +The `Log` object can write information to several log listeners. You need to determine the current configuration of the log listeners before changing the configurations. For more information, see [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md). -You may want to review [How to: Write Event Information to a Text File](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-event-information-to-a-text-file.md) or [How to: Write to an Application Event Log](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md). +You may want to review [How to: Write Event Information to a Text File](how-to-write-event-information-to-a-text-file.md) or [How to: Write to an Application Event Log](how-to-write-to-an-application-event-log.md). ### To add listeners @@ -183,5 +183,5 @@ You may want to review [How to: Write Event Information to a Text File](../../.. - - - -- [How to: Write Event Information to a Text File](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-event-information-to-a-text-file.md) -- [How to: Write to an Application Event Log](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md) +- [How to: Write Event Information to a Text File](how-to-write-event-information-to-a-text-file.md) +- [How to: Write to an Application Event Log](how-to-write-to-an-application-event-log.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-creating-custom-log-listeners.md b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-creating-custom-log-listeners.md index 493a3456c7de9..2454d14193623 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-creating-custom-log-listeners.md +++ b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-creating-custom-log-listeners.md @@ -104,7 +104,7 @@ With the strong name, you can add the listener to the `My.Application.Log` log-l ## See also - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md) -- [How to: Write Log Messages](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md) -- [Walkthrough: Changing Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md) +- [Working with Application Logs](working-with-application-logs.md) +- [How to: Log Exceptions](how-to-log-exceptions.md) +- [How to: Write Log Messages](how-to-write-log-messages.md) +- [Walkthrough: Changing Where My.Application.Log Writes Information](walkthrough-changing-where-my-application-log-writes-information.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md index d251ac58499ea..e32223f583abc 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md +++ b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md @@ -15,7 +15,7 @@ ms.assetid: 5b70143a-7741-45f2-ae1d-03324a3a4189 The `My.Application.Log` object can write information to several log listeners. The log listeners are configured by the computer's configuration file and can be overridden by an application's configuration file. This topic describes the default settings and how to determine the settings for your application. -For more information about the default output locations, see [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md). +For more information about the default output locations, see [Working with Application Logs](working-with-application-logs.md). ### To determine the listeners for My.Application.Log @@ -67,9 +67,9 @@ For more information about the default output locations, see [Working with Appli - - - -- [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [How to: Log Exceptions](../../../../visual-basic/developing-apps/programming/log-info/how-to-log-exceptions.md) -- [How to: Write Log Messages](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md) -- [Walkthrough: Changing Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md) +- [Working with Application Logs](working-with-application-logs.md) +- [How to: Log Exceptions](how-to-log-exceptions.md) +- [How to: Write Log Messages](how-to-write-log-messages.md) +- [Walkthrough: Changing Where My.Application.Log Writes Information](walkthrough-changing-where-my-application-log-writes-information.md) - [ETW Events in the .NET Framework](../../../../framework/performance/etw-events.md) -- [Troubleshooting: Log Listeners](../../../../visual-basic/developing-apps/programming/log-info/troubleshooting-log-listeners.md) +- [Troubleshooting: Log Listeners](troubleshooting-log-listeners.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md index fc2b776906794..8fdbd78e1cdf1 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md +++ b/docs/visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md @@ -37,7 +37,7 @@ Each message that `My.Application.Log` writes has an associated severity level, 6. Close the application. - For information on how to view the application's debug output window, see [Output Window](/visualstudio/ide/reference/output-window). For information on the location of the application's log file, see [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md). + For information on how to view the application's debug output window, see [Output Window](/visualstudio/ide/reference/output-window). For information on the location of the application's log file, see [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md). > [!NOTE] > By default, the application flushes the log-file output when the application closes. @@ -243,13 +243,13 @@ This example demonstrates how to configure filtering for a new debug listener an 10. Close the application. -For more information about changing log settings after deployment, see [Working with Application Logs](../../../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md). +For more information about changing log settings after deployment, see [Working with Application Logs](working-with-application-logs.md). ## See also -- [Walkthrough: Determining Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md) -- [Walkthrough: Changing Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md) -- [Walkthrough: Creating Custom Log Listeners](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-creating-custom-log-listeners.md) -- [How to: Write Log Messages](../../../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md) +- [Walkthrough: Determining Where My.Application.Log Writes Information](walkthrough-determining-where-my-application-log-writes-information.md) +- [Walkthrough: Changing Where My.Application.Log Writes Information](walkthrough-changing-where-my-application-log-writes-information.md) +- [Walkthrough: Creating Custom Log Listeners](walkthrough-creating-custom-log-listeners.md) +- [How to: Write Log Messages](how-to-write-log-messages.md) - [Trace Switches](../../../../framework/debug-trace-profile/trace-switches.md) -- [Logging Information from the Application](../../../../visual-basic/developing-apps/programming/log-info/index.md) +- [Logging Information from the Application](index.md) diff --git a/docs/visual-basic/developing-apps/programming/log-info/working-with-application-logs.md b/docs/visual-basic/developing-apps/programming/log-info/working-with-application-logs.md index 7552a53edd3bd..8510c0dbd9ab3 100644 --- a/docs/visual-basic/developing-apps/programming/log-info/working-with-application-logs.md +++ b/docs/visual-basic/developing-apps/programming/log-info/working-with-application-logs.md @@ -40,11 +40,11 @@ C:\Documents and Settings\\`username`\Application Data The values of `CompanyName`, `ProductName`, and `ProductVersion` come from the application's assembly information. The form of the log file name is *AssemblyName*.log, where *AssemblyName* is the file name of the assembly without the extension. If more than one log file is needed, such as when the original log is unavailable when the application attempts to write to the log, the form for the log file name is *AssemblyName*-*iteration*.log, where `iteration` is a positive `Integer`. -You can override the default behavior by adding or changing the computer's and the application's configuration files. For more information, see [Walkthrough: Changing Where My.Application.Log Writes Information](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md). +You can override the default behavior by adding or changing the computer's and the application's configuration files. For more information, see [Walkthrough: Changing Where My.Application.Log Writes Information](walkthrough-changing-where-my-application-log-writes-information.md). ## Configuring Log Settings -The `Log` object has a default implementation that works without an application configuration file, app.config. To change the defaults, you must add a configuration file with the new settings. For more information, see [Walkthrough: Filtering My.Application.Log Output](../../../../visual-basic/developing-apps/programming/log-info/walkthrough-filtering-my-application-log-output.md). +The `Log` object has a default implementation that works without an application configuration file, app.config. To change the defaults, you must add a configuration file with the new settings. For more information, see [Walkthrough: Filtering My.Application.Log Output](walkthrough-filtering-my-application-log-output.md). The log configuration sections are located in the `` node in the main `` node of the app.config file. Log information is defined in several nodes: @@ -104,4 +104,4 @@ Consider the following when writing data to the log: ## See also - -- [Logging Information from the Application](../../../../visual-basic/developing-apps/programming/log-info/index.md) +- [Logging Information from the Application](index.md) diff --git a/docs/visual-basic/developing-apps/windows-forms/index.md b/docs/visual-basic/developing-apps/windows-forms/index.md index 344c2a557fba8..d43da52d73c68 100644 --- a/docs/visual-basic/developing-apps/windows-forms/index.md +++ b/docs/visual-basic/developing-apps/windows-forms/index.md @@ -104,4 +104,4 @@ For step-by-step information about using these features, see the following Help - - [Windows Forms Overview](../../../framework/winforms/windows-forms-overview.md) -- [My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md) +- [My.Forms Object](../../language-reference/objects/my-forms-object.md) diff --git a/docs/visual-basic/getting-started/additional-resources.md b/docs/visual-basic/getting-started/additional-resources.md index f07901269eaed..d2c4e91fd6a82 100644 --- a/docs/visual-basic/getting-started/additional-resources.md +++ b/docs/visual-basic/getting-started/additional-resources.md @@ -57,5 +57,5 @@ The following web sites provide guidance and can help you find answers to common ## See also -- [Get started with Visual Basic](../../visual-basic/getting-started/index.md) +- [Get started with Visual Basic](index.md) - [Talk to Us](/visualstudio/ide/feedback-options) diff --git a/docs/visual-basic/getting-started/whats-new.md b/docs/visual-basic/getting-started/whats-new.md index 549a21511c4ad..00fe590791891 100644 --- a/docs/visual-basic/getting-started/whats-new.md +++ b/docs/visual-basic/getting-started/whats-new.md @@ -204,7 +204,7 @@ For more information, see [Reference Return Values](../programming-guide/languag You can get the unqualified string name of a type or member for use in an error message without hard coding a string. This allows your code to remain correct when refactoring. This feature is also useful for hooking up model-view-controller MVC links and firing property changed events. -[String interpolation](../../visual-basic/programming-guide/language-features/strings/interpolated-strings.md) +[String interpolation](../programming-guide/language-features/strings/interpolated-strings.md) You can use string interpolation expressions to construct strings. An interpolated string expression looks like a template string that contains expressions. An interpolated string is easier to understand with respect to arguments than [Composite Formatting](../../standard/base-types/composite-formatting.md). @@ -212,7 +212,7 @@ You can use string interpolation expressions to construct strings. An interpola You can test for null in a very light syntactic way before performing a member access (`?.`) or index (`?[]`) operation. These operators help you write less code to handle null checks, especially for descending into data structures. If the left operand or object reference is null, the operations returns null. -[Multi-line string literals](../../visual-basic/programming-guide/language-features/strings/string-basics.md) +[Multi-line string literals](../programming-guide/language-features/strings/string-basics.md) String literals can contain newline sequences. You no longer need the old work around of using `.Value` @@ -232,11 +232,11 @@ You can have date literals in yyyy-mm-dd format, `#2015-03-17 16:10 PM#`. You can implement readonly interface properties using a readwrite property. The interface guarantees minimum functionality, and it does not stop an implementing class from allowing the property to be set. -[TypeOf \ IsNot \](../../visual-basic/language-reference/operators/typeof-operator.md) +[TypeOf \ IsNot \](../language-reference/operators/typeof-operator.md) For more readability of your code, you can now use `TypeOf` with `IsNot`. -[#Disable Warning \ and #Enable Warning \](../../visual-basic/language-reference/directives/index.md) +[#Disable Warning \ and #Enable Warning \](../language-reference/directives/index.md) You can disable and enable specific warnings for regions within a source file. @@ -244,15 +244,15 @@ You can disable and enable specific warnings for regions within a source file. When writing doc comments, you get smart editor and build support for validating parameter names, proper handling of `crefs` (generics, operators, etc.), colorizing, and refactoring. -[Partial module and interface definitions](../../visual-basic/language-reference/modifiers/partial.md) +[Partial module and interface definitions](../language-reference/modifiers/partial.md) In addition to classes and structs, you can declare partial modules and interfaces. -[#Region directives inside method bodies](../../visual-basic/language-reference/directives/region-directive.md) +[#Region directives inside method bodies](../language-reference/directives/region-directive.md) You can put #Region…#End Region delimiters anywhere in a file, inside functions, and even spanning across function bodies. -[Overrides definitions are implicitly overloads](../../visual-basic/language-reference/modifiers/overrides.md) +[Overrides definitions are implicitly overloads](../language-reference/modifiers/overrides.md) If you add the `Overrides` modifier to a definition, the compiler implicitly adds `Overloads` so that you can type less code in common cases. diff --git a/docs/visual-basic/language-reference/attributes.md b/docs/visual-basic/language-reference/attributes.md index e43a625216012..4fd9ff26ae43b 100644 --- a/docs/visual-basic/language-reference/attributes.md +++ b/docs/visual-basic/language-reference/attributes.md @@ -18,4 +18,4 @@ Visual Basic provides several attributes that allow objects to interoperate with ## See also -- [Attributes overview](../../visual-basic/programming-guide/concepts/attributes/index.md) +- [Attributes overview](../programming-guide/concepts/attributes/index.md) diff --git a/docs/visual-basic/language-reference/constants-and-enumerations.md b/docs/visual-basic/language-reference/constants-and-enumerations.md index 1ffe96c964c06..ad7041a38e383 100644 --- a/docs/visual-basic/language-reference/constants-and-enumerations.md +++ b/docs/visual-basic/language-reference/constants-and-enumerations.md @@ -21,7 +21,7 @@ Visual Basic supplies a number of predefined constants and enumerations for deve |---|---| |`CONFIG`|A string that corresponds to the current setting of the **Active Solution Configuration** box in the **Configuration Manager**.| |`DEBUG`|A `Boolean` value that can be set in the **Project Properties** dialog box. By default, the Debug configuration for a project defines `DEBUG`. When `DEBUG` is defined, class methods generate output to the **Output** window. When it is not defined, class methods are not compiled and no Debug output is generated.| -|`TARGET`|A string representing the output type for the project or the setting of the command-line **-target** option. The possible values of `TARGET` are:

- "winexe" for a Windows application.
- "exe" for a console application.
- "library" for a class library.
- "module" for a module.
- The **-target** option may be set in the Visual Studio integrated development environment. For more information, see [-target (Visual Basic)](../../visual-basic/reference/command-line-compiler/target.md).| +|`TARGET`|A string representing the output type for the project or the setting of the command-line **-target** option. The possible values of `TARGET` are:

- "winexe" for a Windows application.
- "exe" for a console application.
- "library" for a class library.
- "module" for a module.
- The **-target** option may be set in the Visual Studio integrated development environment. For more information, see [-target (Visual Basic)](../reference/command-line-compiler/target.md).| |`TRACE`|A `Boolean` value that can be set in the **Project Properties** dialog box. By default, all configurations for a project define `TRACE`. When `TRACE` is defined, class methods generate output to the **Output** window. When it is not defined, class methods are not compiled and no `Trace` output is generated.| |`VBC_VER`|A number representing the Visual Basic version, in *major*.*minor* format.| @@ -77,6 +77,6 @@ Visual Basic supplies a number of predefined constants and enumerations for deve ## See also -- [Visual Basic Language Reference](../../visual-basic/language-reference/index.md) -- [Constants Overview](../../visual-basic/programming-guide/language-features/constants-enums/constants-overview.md) -- [Enumerations Overview](../../visual-basic/programming-guide/language-features/constants-enums/enumerations-overview.md) +- [Visual Basic Language Reference](index.md) +- [Constants Overview](../programming-guide/language-features/constants-enums/constants-overview.md) +- [Enumerations Overview](../programming-guide/language-features/constants-enums/enumerations-overview.md) diff --git a/docs/visual-basic/language-reference/data-types/boolean-data-type.md b/docs/visual-basic/language-reference/data-types/boolean-data-type.md index 04748cfd8b010..e3736245a8f30 100644 --- a/docs/visual-basic/language-reference/data-types/boolean-data-type.md +++ b/docs/visual-basic/language-reference/data-types/boolean-data-type.md @@ -19,7 +19,7 @@ Holds values that can be only `True` or `False`. The keywords `True` and `False` ## Remarks - Use the [Boolean Data Type (Visual Basic)](../../../visual-basic/language-reference/data-types/boolean-data-type.md) to contain two-state values such as true/false, yes/no, or on/off. + Use the [Boolean Data Type (Visual Basic)](boolean-data-type.md) to contain two-state values such as true/false, yes/no, or on/off. The default value of `Boolean` is `False`. @@ -29,7 +29,7 @@ Holds values that can be only `True` or `False`. The keywords `True` and `False` When Visual Basic converts numeric data type values to `Boolean`, 0 becomes `False` and all other values become `True`. When Visual Basic converts `Boolean` values to numeric types, `False` becomes 0 and `True` becomes -1. - When you convert between `Boolean` values and numeric data types, keep in mind that the .NET Framework conversion methods do not always produce the same results as the Visual Basic conversion keywords. This is because the Visual Basic conversion retains behavior compatible with previous versions. For more information, see "Boolean Type Does Not Convert to Numeric Type Accurately" in [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md). + When you convert between `Boolean` values and numeric data types, keep in mind that the .NET Framework conversion methods do not always produce the same results as the Visual Basic conversion keywords. This is because the Visual Basic conversion retains behavior compatible with previous versions. For more information, see "Boolean Type Does Not Convert to Numeric Type Accurately" in [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md). ## Programming Tips @@ -54,9 +54,9 @@ End If ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) -- [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md) -- [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md) +- [CType Function](../functions/ctype-function.md) diff --git a/docs/visual-basic/language-reference/data-types/byte-data-type.md b/docs/visual-basic/language-reference/data-types/byte-data-type.md index b98c896ec0153..7f28c5c589919 100644 --- a/docs/visual-basic/language-reference/data-types/byte-data-type.md +++ b/docs/visual-basic/language-reference/data-types/byte-data-type.md @@ -62,7 +62,7 @@ Dim number As Byte = &H_6A ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/char-data-type.md b/docs/visual-basic/language-reference/data-types/char-data-type.md index 9baf14721d0f0..dbf9d84881dc3 100644 --- a/docs/visual-basic/language-reference/data-types/char-data-type.md +++ b/docs/visual-basic/language-reference/data-types/char-data-type.md @@ -31,7 +31,7 @@ You can use methods like and or function to convert a `Char` value to an `Integer` that represents its code point. You can use the or function to convert an `Integer` value to a `Char` that has that code point. -If the type checking switch (the [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md)) is on, you must append the literal type character to a single-character string literal to identify it as the `Char` data type. The following example illustrates this. The first assignment to the `charVar` variable generates compiler error [BC30512](../../misc/bc30512.md) because `Option Strict` is on. The second compiles successfully because the `c` literal type character identifies the literal as a `Char` value. +If the type checking switch (the [Option Strict Statement](../statements/option-strict-statement.md)) is on, you must append the literal type character to a single-character string literal to identify it as the `Char` data type. The following example illustrates this. The first assignment to the `charVar` variable generates compiler error [BC30512](../../misc/bc30512.md) because `Option Strict` is on. The second compiles successfully because the `c` literal type character identifies the literal as a `Char` value. ```vb Option Strict On @@ -68,9 +68,9 @@ End Module - - - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [String Data Type](../../../visual-basic/language-reference/data-types/string-data-type.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [How to: Call a Windows Function that Takes Unsigned Types](../../../visual-basic/programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [String Data Type](string-data-type.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [How to: Call a Windows Function that Takes Unsigned Types](../../programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/date-data-type.md b/docs/visual-basic/language-reference/data-types/date-data-type.md index 6f0349c53ca4d..a1c52d2a202c7 100644 --- a/docs/visual-basic/language-reference/data-types/date-data-type.md +++ b/docs/visual-basic/language-reference/data-types/date-data-type.md @@ -79,9 +79,9 @@ Dim someDateAndTime As Date = #8/13/2002 12:14 PM# ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) +- [Data Types](index.md) - [Standard Date and Time Format Strings](../../../standard/base-types/standard-date-and-time-format-strings.md) - [Custom Date and Time Format Strings](../../../standard/base-types/custom-date-and-time-format-strings.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/decimal-data-type.md b/docs/visual-basic/language-reference/data-types/decimal-data-type.md index 7c8fdc2c772d6..239890b3a9ce9 100644 --- a/docs/visual-basic/language-reference/data-types/decimal-data-type.md +++ b/docs/visual-basic/language-reference/data-types/decimal-data-type.md @@ -82,9 +82,9 @@ For `bigDec3`, the literal type character `D` solves the problem by forcing the - - - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Single Data Type](../../../visual-basic/language-reference/data-types/single-data-type.md) -- [Double Data Type](../../../visual-basic/language-reference/data-types/double-data-type.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Single Data Type](single-data-type.md) +- [Double Data Type](double-data-type.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/double-data-type.md b/docs/visual-basic/language-reference/data-types/double-data-type.md index e6340aad7f347..78906a9a0870e 100644 --- a/docs/visual-basic/language-reference/data-types/double-data-type.md +++ b/docs/visual-basic/language-reference/data-types/double-data-type.md @@ -32,7 +32,7 @@ The default value of `Double` is 0. ## Programming Tips -- **Precision.** When you work with floating-point numbers, remember that they do not always have a precise representation in memory. This could lead to unexpected results from certain operations, such as value comparison and the `Mod` operator. For more information, see [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md). +- **Precision.** When you work with floating-point numbers, remember that they do not always have a precise representation in memory. This could lead to unexpected results from certain operations, such as value comparison and the `Mod` operator. For more information, see [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md). - **Trailing Zeros.** The floating-point data types do not have any internal representation of trailing zero characters. For example, they do not distinguish between 4.2000 and 4.2. Consequently, trailing zero characters do not appear when you display or print floating-point values. @@ -54,11 +54,11 @@ The default value of `Double` is 0. ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Decimal Data Type](../../../visual-basic/language-reference/data-types/decimal-data-type.md) -- [Single Data Type](../../../visual-basic/language-reference/data-types/single-data-type.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) -- [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md) -- [Type Characters](../../../visual-basic/programming-guide/language-features/data-types/type-characters.md) +- [Data Types](index.md) +- [Decimal Data Type](decimal-data-type.md) +- [Single Data Type](single-data-type.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md) +- [Type Characters](../../programming-guide/language-features/data-types/type-characters.md) diff --git a/docs/visual-basic/language-reference/data-types/index.md b/docs/visual-basic/language-reference/data-types/index.md index fa77a8be39a78..ad220d00738ca 100644 --- a/docs/visual-basic/language-reference/data-types/index.md +++ b/docs/visual-basic/language-reference/data-types/index.md @@ -44,30 +44,30 @@ The following table shows the Visual Basic data types, their supporting common l |Visual Basic type|Common language runtime type structure|Nominal storage allocation|Value range| |-----------------------|--------------------------------------------|--------------------------------|-----------------| -|[Boolean](../../../visual-basic/language-reference/data-types/boolean-data-type.md)||Depends on implementing platform|`True` or `False`| -|[Byte](../../../visual-basic/language-reference/data-types/byte-data-type.md)||1 byte|0 through 255 (unsigned)| -|[Char](../../../visual-basic/language-reference/data-types/char-data-type.md) (single character)||2 bytes|0 through 65535 (unsigned)| -|[Date](../../../visual-basic/language-reference/data-types/date-data-type.md)||8 bytes|0:00:00 (midnight) on January 1, 0001 through 11:59:59 PM on December 31, 9999| -|[Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md)||16 bytes|0 through +/-79,228,162,514,264,337,593,543,950,335 (+/-7.9...E+28) with no decimal point; 0 through +/-7.9228162514264337593543950335 with 28 places to the right of the decimal;

smallest nonzero number is +/-0.0000000000000000000000000001 (+/-1E-28) | -|[Double](../../../visual-basic/language-reference/data-types/double-data-type.md) (double-precision floating-point)||8 bytes|-1.79769313486231570E+308 through -4.94065645841246544E-324 for negative values;

4.94065645841246544E-324 through 1.79769313486231570E+308 for positive values| -|[Integer](../../../visual-basic/language-reference/data-types/integer-data-type.md)||4 bytes|-2,147,483,648 through 2,147,483,647 (signed)| -|[Long](../../../visual-basic/language-reference/data-types/long-data-type.md) (long integer)||8 bytes|-9,223,372,036,854,775,808 through 9,223,372,036,854,775,807 (9.2...E+18 ) (signed)| -|[Object](../../../visual-basic/language-reference/data-types/object-data-type.md)| (class)|4 bytes on 32-bit platform

8 bytes on 64-bit platform|Any type can be stored in a variable of type `Object`| -|[SByte](../../../visual-basic/language-reference/data-types/sbyte-data-type.md)||1 byte|-128 through 127 (signed)| -|[Short](../../../visual-basic/language-reference/data-types/short-data-type.md) (short integer)||2 bytes|-32,768 through 32,767 (signed)| -|[Single](../../../visual-basic/language-reference/data-types/single-data-type.md) (single-precision floating-point)||4 bytes|-3.4028235E+38 through -1.401298E-45 for negative values;

1.401298E-45 through 3.4028235E+38 for positive values| -|[String](../../../visual-basic/language-reference/data-types/string-data-type.md) (variable-length)| (class)|Depends on implementing platform|0 to approximately 2 billion Unicode characters| -|[UInteger](../../../visual-basic/language-reference/data-types/uinteger-data-type.md)||4 bytes|0 through 4,294,967,295 (unsigned)| -|[ULong](../../../visual-basic/language-reference/data-types/ulong-data-type.md)||8 bytes|0 through 18,446,744,073,709,551,615 (1.8...E+19 ) (unsigned)| -|[User-Defined](../../../visual-basic/language-reference/data-types/user-defined-data-type.md) (structure)|(inherits from )|Depends on implementing platform|Each member of the structure has a range determined by its data type and independent of the ranges of the other members| -|[UShort](../../../visual-basic/language-reference/data-types/ushort-data-type.md)||2 bytes|0 through 65,535 (unsigned)| +|[Boolean](boolean-data-type.md)||Depends on implementing platform|`True` or `False`| +|[Byte](byte-data-type.md)||1 byte|0 through 255 (unsigned)| +|[Char](char-data-type.md) (single character)||2 bytes|0 through 65535 (unsigned)| +|[Date](date-data-type.md)||8 bytes|0:00:00 (midnight) on January 1, 0001 through 11:59:59 PM on December 31, 9999| +|[Decimal](decimal-data-type.md)||16 bytes|0 through +/-79,228,162,514,264,337,593,543,950,335 (+/-7.9...E+28) with no decimal point; 0 through +/-7.9228162514264337593543950335 with 28 places to the right of the decimal;

smallest nonzero number is +/-0.0000000000000000000000000001 (+/-1E-28) | +|[Double](double-data-type.md) (double-precision floating-point)||8 bytes|-1.79769313486231570E+308 through -4.94065645841246544E-324 for negative values;

4.94065645841246544E-324 through 1.79769313486231570E+308 for positive values| +|[Integer](integer-data-type.md)||4 bytes|-2,147,483,648 through 2,147,483,647 (signed)| +|[Long](long-data-type.md) (long integer)||8 bytes|-9,223,372,036,854,775,808 through 9,223,372,036,854,775,807 (9.2...E+18 ) (signed)| +|[Object](object-data-type.md)| (class)|4 bytes on 32-bit platform

8 bytes on 64-bit platform|Any type can be stored in a variable of type `Object`| +|[SByte](sbyte-data-type.md)||1 byte|-128 through 127 (signed)| +|[Short](short-data-type.md) (short integer)||2 bytes|-32,768 through 32,767 (signed)| +|[Single](single-data-type.md) (single-precision floating-point)||4 bytes|-3.4028235E+38 through -1.401298E-45 for negative values;

1.401298E-45 through 3.4028235E+38 for positive values| +|[String](string-data-type.md) (variable-length)| (class)|Depends on implementing platform|0 to approximately 2 billion Unicode characters| +|[UInteger](uinteger-data-type.md)||4 bytes|0 through 4,294,967,295 (unsigned)| +|[ULong](ulong-data-type.md)||8 bytes|0 through 18,446,744,073,709,551,615 (1.8...E+19 ) (unsigned)| +|[User-Defined](user-defined-data-type.md) (structure)|(inherits from )|Depends on implementing platform|Each member of the structure has a range determined by its data type and independent of the ranges of the other members| +|[UShort](ushort-data-type.md)||2 bytes|0 through 65,535 (unsigned)| In *scientific notation*, "E" refers to a power of 10. So 3.56E+2 signifies 3.56 x 102 or 356, and 3.56E-2 signifies 3.56 / 102 or 0.0356. > [!NOTE] > For strings containing text, use the function to convert from one text format to another. - In addition to specifying a data type in a declaration statement, you can force the data type of some programming elements by using a type character. See [Type Characters](../../../visual-basic/programming-guide/language-features/data-types/type-characters.md). + In addition to specifying a data type in a declaration statement, you can force the data type of some programming elements by using a type character. See [Type Characters](../../programming-guide/language-features/data-types/type-characters.md). ## Memory Consumption @@ -93,7 +93,7 @@ The following table shows the Visual Basic data types, their supporting common l - - -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Type Characters](../../../visual-basic/programming-guide/language-features/data-types/type-characters.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Type Characters](../../programming-guide/language-features/data-types/type-characters.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/integer-data-type.md b/docs/visual-basic/language-reference/data-types/integer-data-type.md index 33fb6689fef90..c30bb3d59a618 100644 --- a/docs/visual-basic/language-reference/data-types/integer-data-type.md +++ b/docs/visual-basic/language-reference/data-types/integer-data-type.md @@ -92,9 +92,9 @@ k = 5.5 ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Long Data Type](../../../visual-basic/language-reference/data-types/long-data-type.md) -- [Short Data Type](../../../visual-basic/language-reference/data-types/short-data-type.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Long Data Type](long-data-type.md) +- [Short Data Type](short-data-type.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/long-data-type.md b/docs/visual-basic/language-reference/data-types/long-data-type.md index dc3d850f2eb58..ade3a35761390 100644 --- a/docs/visual-basic/language-reference/data-types/long-data-type.md +++ b/docs/visual-basic/language-reference/data-types/long-data-type.md @@ -73,9 +73,9 @@ Dim number = &H_0FAC_0326_1489_D68CL ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Integer Data Type](../../../visual-basic/language-reference/data-types/integer-data-type.md) -- [Short Data Type](../../../visual-basic/language-reference/data-types/short-data-type.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Integer Data Type](integer-data-type.md) +- [Short Data Type](short-data-type.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/object-data-type.md b/docs/visual-basic/language-reference/data-types/object-data-type.md index ace785db7a347..a62e012cf093a 100644 --- a/docs/visual-basic/language-reference/data-types/object-data-type.md +++ b/docs/visual-basic/language-reference/data-types/object-data-type.md @@ -68,9 +68,9 @@ objDb = myCollection.Item(1) ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) -- [How to: Determine Whether Two Objects Are Related](../../../visual-basic/programming-guide/language-features/variables/how-to-determine-whether-two-objects-are-related.md) -- [How to: Determine Whether Two Objects Are Identical](../../../visual-basic/programming-guide/language-features/variables/how-to-determine-whether-two-objects-are-identical.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [How to: Determine Whether Two Objects Are Related](../../programming-guide/language-features/variables/how-to-determine-whether-two-objects-are-related.md) +- [How to: Determine Whether Two Objects Are Identical](../../programming-guide/language-features/variables/how-to-determine-whether-two-objects-are-identical.md) diff --git a/docs/visual-basic/language-reference/data-types/sbyte-data-type.md b/docs/visual-basic/language-reference/data-types/sbyte-data-type.md index 1b6258a01e601..f65ac1d23eb63 100644 --- a/docs/visual-basic/language-reference/data-types/sbyte-data-type.md +++ b/docs/visual-basic/language-reference/data-types/sbyte-data-type.md @@ -69,10 +69,10 @@ If the integer literal is outside the range of `SByte` (that is, if it is less t ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Short Data Type](../../../visual-basic/language-reference/data-types/short-data-type.md) -- [Integer Data Type](../../../visual-basic/language-reference/data-types/integer-data-type.md) -- [Long Data Type](../../../visual-basic/language-reference/data-types/long-data-type.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Short Data Type](short-data-type.md) +- [Integer Data Type](integer-data-type.md) +- [Long Data Type](long-data-type.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/short-data-type.md b/docs/visual-basic/language-reference/data-types/short-data-type.md index 6eb15ce304875..1170b4afdd764 100644 --- a/docs/visual-basic/language-reference/data-types/short-data-type.md +++ b/docs/visual-basic/language-reference/data-types/short-data-type.md @@ -67,9 +67,9 @@ Dim number = &H_3264S ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Integer Data Type](../../../visual-basic/language-reference/data-types/integer-data-type.md) -- [Long Data Type](../../../visual-basic/language-reference/data-types/long-data-type.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Integer Data Type](integer-data-type.md) +- [Long Data Type](long-data-type.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/single-data-type.md b/docs/visual-basic/language-reference/data-types/single-data-type.md index 39b0c8b61ad68..459cf2cc1ed36 100644 --- a/docs/visual-basic/language-reference/data-types/single-data-type.md +++ b/docs/visual-basic/language-reference/data-types/single-data-type.md @@ -33,7 +33,7 @@ Holds signed IEEE 32-bit (4-byte) single-precision floating-point numbers rangin ## Programming Tips -- **Precision.** When you work with floating-point numbers, keep in mind that they do not always have a precise representation in memory. This could lead to unexpected results from certain operations, such as value comparison and the `Mod` operator. For more information, see [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md). +- **Precision.** When you work with floating-point numbers, keep in mind that they do not always have a precise representation in memory. This could lead to unexpected results from certain operations, such as value comparison and the `Mod` operator. For more information, see [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md). - **Widening.** The `Single` data type widens to `Double`. This means you can convert `Single` to `Double` without encountering a error. @@ -46,10 +46,10 @@ Holds signed IEEE 32-bit (4-byte) single-precision floating-point numbers rangin ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Decimal Data Type](../../../visual-basic/language-reference/data-types/decimal-data-type.md) -- [Double Data Type](../../../visual-basic/language-reference/data-types/double-data-type.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) -- [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md) +- [Data Types](index.md) +- [Decimal Data Type](decimal-data-type.md) +- [Double Data Type](double-data-type.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/string-data-type.md b/docs/visual-basic/language-reference/data-types/string-data-type.md index 8e0a92cf6268d..b94213f960902 100644 --- a/docs/visual-basic/language-reference/data-types/string-data-type.md +++ b/docs/visual-basic/language-reference/data-types/string-data-type.md @@ -65,7 +65,7 @@ S = Microsoft.VisualBasic.Left(S, 4) A string created by another component might be padded with leading or trailing spaces. If you receive such a string, you can use the , , and functions to remove these spaces. - For more information about string manipulations, see [Strings](../../../visual-basic/programming-guide/language-features/strings/index.md). + For more information about string manipulations, see [Strings](../../programming-guide/language-features/strings/index.md). ## Programming Tips @@ -80,9 +80,9 @@ S = Microsoft.VisualBasic.Left(S, 4) ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Char Data Type](../../../visual-basic/language-reference/data-types/char-data-type.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [How to: Call a Windows Function that Takes Unsigned Types](../../../visual-basic/programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Char Data Type](char-data-type.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [How to: Call a Windows Function that Takes Unsigned Types](../../programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/uinteger-data-type.md b/docs/visual-basic/language-reference/data-types/uinteger-data-type.md index e5944d66285a3..b6c4d885e1e14 100644 --- a/docs/visual-basic/language-reference/data-types/uinteger-data-type.md +++ b/docs/visual-basic/language-reference/data-types/uinteger-data-type.md @@ -75,8 +75,8 @@ The `UInteger` and `Integer` data types provide optimal performance on a 32-bit ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [How to: Call a Windows Function that Takes Unsigned Types](../../../visual-basic/programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [How to: Call a Windows Function that Takes Unsigned Types](../../programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/ulong-data-type.md b/docs/visual-basic/language-reference/data-types/ulong-data-type.md index 41bf33cb820e6..b89b111fc0ccb 100644 --- a/docs/visual-basic/language-reference/data-types/ulong-data-type.md +++ b/docs/visual-basic/language-reference/data-types/ulong-data-type.md @@ -75,8 +75,8 @@ Dim number = &H_00_00_0A_96_2F_AC_14_D7ul ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [How to: Call a Windows Function that Takes Unsigned Types](../../../visual-basic/programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [How to: Call a Windows Function that Takes Unsigned Types](../../programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/user-defined-data-type.md b/docs/visual-basic/language-reference/data-types/user-defined-data-type.md index 99b131a0e796b..4dfa84fb6f65d 100644 --- a/docs/visual-basic/language-reference/data-types/user-defined-data-type.md +++ b/docs/visual-basic/language-reference/data-types/user-defined-data-type.md @@ -38,13 +38,13 @@ The default value of a structure data type consists of the combination of the de ## Declaration Format -A structure declaration starts with the [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) and ends with the `End Structure` statement. The `Structure` statement supplies the name of the structure, which is also the identifier of the data type the structure is defining. Other parts of the code can use this identifier to declare variables, parameters, and function return values to be of this structure's data type. +A structure declaration starts with the [Structure Statement](../statements/structure-statement.md) and ends with the `End Structure` statement. The `Structure` statement supplies the name of the structure, which is also the identifier of the data type the structure is defining. Other parts of the code can use this identifier to declare variables, parameters, and function return values to be of this structure's data type. The declarations between the `Structure` and `End Structure` statements define the members of the structure. ## Member Access Levels -You must declare every member using a [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) or a statement that specifies access level, such as [Public](../../../visual-basic/language-reference/modifiers/public.md), [Friend](../../../visual-basic/language-reference/modifiers/friend.md), or [Private](../../../visual-basic/language-reference/modifiers/private.md). If you use a `Dim` statement, the access level defaults to public. +You must declare every member using a [Dim Statement](../statements/dim-statement.md) or a statement that specifies access level, such as [Public](../modifiers/public.md), [Friend](../modifiers/friend.md), or [Private](../modifiers/private.md). If you use a `Dim` statement, the access level defaults to public. ## Programming Tips @@ -52,7 +52,7 @@ You must declare every member using a [Dim Statement](../../../visual-basic/lang - **Interop Considerations.** If you are interfacing with components not written for the .NET Framework, for example Automation or COM objects, keep in mind that user-defined types in other environments are not compatible with Visual Basic structure types. -- **Widening.** There is no automatic conversion to or from any structure data type. You can define conversion operators on your structure using the [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md), and you can declare each conversion operator to be `Widening` or `Narrowing`. +- **Widening.** There is no automatic conversion to or from any structure data type. You can define conversion operators on your structure using the [Operator Statement](../statements/operator-statement.md), and you can declare each conversion operator to be `Widening` or `Narrowing`. - **Type Characters.** Structure data types have no literal type character or identifier type character. @@ -74,11 +74,11 @@ End Structure - - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) -- [Widening](../../../visual-basic/language-reference/modifiers/widening.md) -- [Narrowing](../../../visual-basic/language-reference/modifiers/narrowing.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [Structure Statement](../statements/structure-statement.md) +- [Widening](../modifiers/widening.md) +- [Narrowing](../modifiers/narrowing.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/data-types/ushort-data-type.md b/docs/visual-basic/language-reference/data-types/ushort-data-type.md index 02d99c68aa591..7b7aa3db387b4 100644 --- a/docs/visual-basic/language-reference/data-types/ushort-data-type.md +++ b/docs/visual-basic/language-reference/data-types/ushort-data-type.md @@ -71,8 +71,8 @@ Dim number = &H_5826us ## See also - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Summary](../../../visual-basic/language-reference/keywords/conversion-summary.md) -- [How to: Call a Windows Function that Takes Unsigned Types](../../../visual-basic/programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) -- [Efficient Use of Data Types](../../../visual-basic/programming-guide/language-features/data-types/efficient-use-of-data-types.md) +- [Data Types](index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Conversion Summary](../keywords/conversion-summary.md) +- [How to: Call a Windows Function that Takes Unsigned Types](../../programming-guide/com-interop/how-to-call-a-windows-function-that-takes-unsigned-types.md) +- [Efficient Use of Data Types](../../programming-guide/language-features/data-types/efficient-use-of-data-types.md) diff --git a/docs/visual-basic/language-reference/directives/const-directive.md b/docs/visual-basic/language-reference/directives/const-directive.md index 1344ddf788bee..3b1ed5d5f6f4d 100644 --- a/docs/visual-basic/language-reference/directives/const-directive.md +++ b/docs/visual-basic/language-reference/directives/const-directive.md @@ -48,8 +48,8 @@ Defines conditional compiler constants for Visual Basic. ## See also -- [-define (Visual Basic)](../../../visual-basic/reference/command-line-compiler/define.md) -- [#If...Then...#Else Directives](../../../visual-basic/language-reference/directives/if-then-else-directives.md) -- [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) -- [Conditional Compilation](../../../visual-basic/programming-guide/program-structure/conditional-compilation.md) -- [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) +- [-define (Visual Basic)](../../reference/command-line-compiler/define.md) +- [#If...Then...#Else Directives](if-then-else-directives.md) +- [Const Statement](../statements/const-statement.md) +- [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) +- [If...Then...Else Statement](../statements/if-then-else-statement.md) diff --git a/docs/visual-basic/language-reference/directives/externalsource-directive.md b/docs/visual-basic/language-reference/directives/externalsource-directive.md index 2c12649b57a87..27391b99f8bfd 100644 --- a/docs/visual-basic/language-reference/directives/externalsource-directive.md +++ b/docs/visual-basic/language-reference/directives/externalsource-directive.md @@ -49,4 +49,4 @@ Indicates a mapping between specific lines of source code and text external to t ## See also -- [Conditional Compilation](../../../visual-basic/programming-guide/program-structure/conditional-compilation.md) +- [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) diff --git a/docs/visual-basic/language-reference/directives/if-then-else-directives.md b/docs/visual-basic/language-reference/directives/if-then-else-directives.md index eb58be584b71b..ed441a914dd88 100644 --- a/docs/visual-basic/language-reference/directives/if-then-else-directives.md +++ b/docs/visual-basic/language-reference/directives/if-then-else-directives.md @@ -80,7 +80,7 @@ This example uses the `#If...Then...#Else` construct to determine whether to com ## See also -- [#Const Directive](../../../visual-basic/language-reference/directives/const-directive.md) -- [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) -- [Conditional Compilation](../../../visual-basic/programming-guide/program-structure/conditional-compilation.md) +- [#Const Directive](const-directive.md) +- [If...Then...Else Statement](../statements/if-then-else-statement.md) +- [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) - diff --git a/docs/visual-basic/language-reference/directives/index.md b/docs/visual-basic/language-reference/directives/index.md index d4eeaa6ac023a..526129deb60ea 100644 --- a/docs/visual-basic/language-reference/directives/index.md +++ b/docs/visual-basic/language-reference/directives/index.md @@ -13,13 +13,13 @@ The topics in this section document the Visual Basic source code compiler direct ## In This Section - [#Const Directive](../../../visual-basic/language-reference/directives/const-directive.md) -- Define a compiler constant + [#Const Directive](const-directive.md) -- Define a compiler constant - [#ExternalSource Directive](../../../visual-basic/language-reference/directives/externalsource-directive.md) -- Indicate a mapping between source lines and text external to the source + [#ExternalSource Directive](externalsource-directive.md) -- Indicate a mapping between source lines and text external to the source - [#If...Then...#Else Directives](../../../visual-basic/language-reference/directives/if-then-else-directives.md) -- Compile selected blocks of code + [#If...Then...#Else Directives](if-then-else-directives.md) -- Compile selected blocks of code - [#Region Directive](../../../visual-basic/language-reference/directives/region-directive.md) -- Collapse and hide sections of code in the Visual Studio editor + [#Region Directive](region-directive.md) -- Collapse and hide sections of code in the Visual Studio editor **#Disable, #Enable** -- Disable and enable specific warnings for regions of code. @@ -35,5 +35,5 @@ The topics in this section document the Visual Basic source code compiler direct ## Related Sections - [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) + [Visual Basic Language Reference](../index.md) \ No newline at end of file diff --git a/docs/visual-basic/language-reference/directives/region-directive.md b/docs/visual-basic/language-reference/directives/region-directive.md index 6251bafd7d679..9b4f3313d355d 100644 --- a/docs/visual-basic/language-reference/directives/region-directive.md +++ b/docs/visual-basic/language-reference/directives/region-directive.md @@ -41,6 +41,6 @@ Collapses and hides sections of code in Visual Basic files. ## See also -- [#If...Then...#Else Directives](../../../visual-basic/language-reference/directives/if-then-else-directives.md) +- [#If...Then...#Else Directives](if-then-else-directives.md) - [Outlining](/visualstudio/ide/outlining) -- [How to: Collapse and Hide Sections of Code](../../../visual-basic/programming-guide/program-structure/how-to-collapse-and-hide-sections-of-code.md) +- [How to: Collapse and Hide Sections of Code](../../programming-guide/program-structure/how-to-collapse-and-hide-sections-of-code.md) diff --git a/docs/visual-basic/language-reference/error-messages/a-double-quote-is-not-a-valid-comment-token-for-delimited-fields.md b/docs/visual-basic/language-reference/error-messages/a-double-quote-is-not-a-valid-comment-token-for-delimited-fields.md index d1b04375c6122..850d2658bb3fd 100644 --- a/docs/visual-basic/language-reference/error-messages/a-double-quote-is-not-a-valid-comment-token-for-delimited-fields.md +++ b/docs/visual-basic/language-reference/error-messages/a-double-quote-is-not-a-valid-comment-token-for-delimited-fields.md @@ -18,4 +18,4 @@ A quotation mark has been supplied as the delimiter for the `TextFieldParser`, b - - - -- [How to: Read From Comma-Delimited Text Files](../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md) +- [How to: Read From Comma-Delimited Text Files](../../developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md) diff --git a/docs/visual-basic/language-reference/error-messages/a-property-or-method-call-cannot-include-a-reference-to-a-private-object.md b/docs/visual-basic/language-reference/error-messages/a-property-or-method-call-cannot-include-a-reference-to-a-private-object.md index f84f80effc2e2..17269bc9359d6 100644 --- a/docs/visual-basic/language-reference/error-messages/a-property-or-method-call-cannot-include-a-reference-to-a-private-object.md +++ b/docs/visual-basic/language-reference/error-messages/a-property-or-method-call-cannot-include-a-reference-to-a-private-object.md @@ -23,4 +23,4 @@ Among the possible causes of this error are: ## See also -- [Private](../../../visual-basic/language-reference/modifiers/private.md) +- [Private](../modifiers/private.md) diff --git a/docs/visual-basic/language-reference/error-messages/a-startup-form-has-not-been-specified.md b/docs/visual-basic/language-reference/error-messages/a-startup-form-has-not-been-specified.md index 8071e11b101b8..a49ffbf471695 100644 --- a/docs/visual-basic/language-reference/error-messages/a-startup-form-has-not-been-specified.md +++ b/docs/visual-basic/language-reference/error-messages/a-startup-form-has-not-been-specified.md @@ -24,4 +24,4 @@ The application uses the - - -- [Overview of the Visual Basic Application Model](../../../visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md) +- [Overview of the Visual Basic Application Model](../../developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md) diff --git a/docs/visual-basic/language-reference/error-messages/argument-not-optional.md b/docs/visual-basic/language-reference/error-messages/argument-not-optional.md index 62e9fdfb432fa..0e20a7f3cbec6 100644 --- a/docs/visual-basic/language-reference/error-messages/argument-not-optional.md +++ b/docs/visual-basic/language-reference/error-messages/argument-not-optional.md @@ -17,4 +17,4 @@ The number and types of arguments must match those expected. Either there is an ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/attribute-attributename-cannot-be-applied-multiple-times.md b/docs/visual-basic/language-reference/error-messages/attribute-attributename-cannot-be-applied-multiple-times.md index 5f9600632330d..cf075ca699680 100644 --- a/docs/visual-basic/language-reference/error-messages/attribute-attributename-cannot-be-applied-multiple-times.md +++ b/docs/visual-basic/language-reference/error-messages/attribute-attributename-cannot-be-applied-multiple-times.md @@ -27,5 +27,5 @@ The attribute can only be applied once. The `AttributeUsage` attribute determine ## See also - -- [Creating Custom Attributes](../../../visual-basic/programming-guide/concepts/attributes/creating-custom-attributes.md) -- [AttributeUsage](../../../visual-basic/programming-guide/concepts/attributes/attributeusage.md) +- [Creating Custom Attributes](../../programming-guide/concepts/attributes/creating-custom-attributes.md) +- [AttributeUsage](../../programming-guide/concepts/attributes/attributeusage.md) diff --git a/docs/visual-basic/language-reference/error-messages/attribute-cannot-be-applied-because-the-format-of-the-guid-is-not-correct.md b/docs/visual-basic/language-reference/error-messages/attribute-cannot-be-applied-because-the-format-of-the-guid-is-not-correct.md index 0ccbe6a7f2f6d..8aa9756ab7650 100644 --- a/docs/visual-basic/language-reference/error-messages/attribute-cannot-be-applied-because-the-format-of-the-guid-is-not-correct.md +++ b/docs/visual-basic/language-reference/error-messages/attribute-cannot-be-applied-because-the-format-of-the-guid-is-not-correct.md @@ -25,4 +25,4 @@ A `COMClassAttribute` attribute block specifies a globally unique identifier (GU ## See also - -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/automation-error.md b/docs/visual-basic/language-reference/error-messages/automation-error.md index 73db122a97b21..d01982ba63e14 100644 --- a/docs/visual-basic/language-reference/error-messages/automation-error.md +++ b/docs/visual-basic/language-reference/error-messages/automation-error.md @@ -17,5 +17,5 @@ An error occurred while executing a method or getting or setting a property of a ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) - [Talk to Us](/visualstudio/ide/feedback-options) diff --git a/docs/visual-basic/language-reference/error-messages/bad-dll-calling-convention.md b/docs/visual-basic/language-reference/error-messages/bad-dll-calling-convention.md index a482cfac7b833..c72a05d1a7fbd 100644 --- a/docs/visual-basic/language-reference/error-messages/bad-dll-calling-convention.md +++ b/docs/visual-basic/language-reference/error-messages/bad-dll-calling-convention.md @@ -18,6 +18,6 @@ Arguments passed to a dynamic-link library (DLL) must exactly match those expect ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) -- [Call Statement](../../../visual-basic/language-reference/statements/call-statement.md) -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Error Types](../../programming-guide/language-features/error-types.md) +- [Call Statement](../statements/call-statement.md) +- [Declare Statement](../statements/declare-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/bad-file-mode.md b/docs/visual-basic/language-reference/error-messages/bad-file-mode.md index 183626e6946a3..aa18b853ad358 100644 --- a/docs/visual-basic/language-reference/error-messages/bad-file-mode.md +++ b/docs/visual-basic/language-reference/error-messages/bad-file-mode.md @@ -31,4 +31,4 @@ Statements used in manipulating file contents must be appropriate to the mode in ## See also - -- [Troubleshooting: Reading from and Writing to Text Files](../../../visual-basic/developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) +- [Troubleshooting: Reading from and Writing to Text Files](../../developing-apps/programming/drives-directories-files/troubleshooting-reading-from-and-writing-to-text-files.md) diff --git a/docs/visual-basic/language-reference/error-messages/bad-file-name-or-number.md b/docs/visual-basic/language-reference/error-messages/bad-file-name-or-number.md index e9d3b6b7fa224..413e51afd7bf2 100644 --- a/docs/visual-basic/language-reference/error-messages/bad-file-name-or-number.md +++ b/docs/visual-basic/language-reference/error-messages/bad-file-name-or-number.md @@ -25,4 +25,4 @@ An error occurred while trying to access the specified file. Among the possible ## See also - -- [Visual Basic Naming Conventions](../../../visual-basic/programming-guide/program-structure/naming-conventions.md) +- [Visual Basic Naming Conventions](../../programming-guide/program-structure/naming-conventions.md) diff --git a/docs/visual-basic/language-reference/error-messages/bc2012.md b/docs/visual-basic/language-reference/error-messages/bc2012.md index 61ca265170385..0cf33098aea01 100644 --- a/docs/visual-basic/language-reference/error-messages/bc2012.md +++ b/docs/visual-basic/language-reference/error-messages/bc2012.md @@ -23,4 +23,4 @@ The specified file cannot be opened for writing, perhaps because it has already - - -- [Writing to Files](../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) +- [Writing to Files](../../developing-apps/programming/drives-directories-files/writing-to-files.md) diff --git a/docs/visual-basic/language-reference/error-messages/bc30306.md b/docs/visual-basic/language-reference/error-messages/bc30306.md index ba214cc3fbfd4..f420e74e5f2b9 100644 --- a/docs/visual-basic/language-reference/error-messages/bc30306.md +++ b/docs/visual-basic/language-reference/error-messages/bc30306.md @@ -19,4 +19,4 @@ An array initialization leaves out one or more of the subscripts that define the ## See also -- [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md) +- [Arrays](../../programming-guide/language-features/arrays/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/bc30310.md b/docs/visual-basic/language-reference/error-messages/bc30310.md index 81b68440251dc..604ec66b8dd6e 100644 --- a/docs/visual-basic/language-reference/error-messages/bc30310.md +++ b/docs/visual-basic/language-reference/error-messages/bc30310.md @@ -22,4 +22,4 @@ The `System.MarshalByRefObject` class enables applications that support remote a ## See also - -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) +- [Dim Statement](../statements/dim-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/bc30828.md b/docs/visual-basic/language-reference/error-messages/bc30828.md index d75232184a23e..497ba08ffc9cb 100644 --- a/docs/visual-basic/language-reference/error-messages/bc30828.md +++ b/docs/visual-basic/language-reference/error-messages/bc30828.md @@ -26,6 +26,6 @@ The `Any` data type was used with `Declare` statements in Visual Basic 6.0 and e ## See also - -- [Walkthrough: Calling Windows APIs](../../../visual-basic/programming-guide/com-interop/walkthrough-calling-windows-apis.md) -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Walkthrough: Calling Windows APIs](../../programming-guide/com-interop/walkthrough-calling-windows-apis.md) +- [Declare Statement](../statements/declare-statement.md) - [Creating Prototypes in Managed Code](../../../framework/interop/creating-prototypes-in-managed-code.md) diff --git a/docs/visual-basic/language-reference/error-messages/bc42358.md b/docs/visual-basic/language-reference/error-messages/bc42358.md index f306d9c271805..33bd10852b491 100644 --- a/docs/visual-basic/language-reference/error-messages/bc42358.md +++ b/docs/visual-basic/language-reference/error-messages/bc42358.md @@ -113,7 +113,7 @@ The following Windows Presentation Foundation (WPF) application contains the met A simple window that contains a button and a text box appears in the **Design** view of MainWindow.xaml. - For more information about the XAML Designer, see [Creating a UI by using XAML Designer](/visualstudio/xaml-tools/creating-a-ui-by-using-xaml-designer-in-visual-studio). For information about how to build your own simple UI, see the "To create a WPF application" and "To design a simple WPF MainWindow" sections of [Walkthrough: Accessing the Web by Using Async and Await](../../../visual-basic/programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md). + For more information about the XAML Designer, see [Creating a UI by using XAML Designer](/visualstudio/xaml-tools/creating-a-ui-by-using-xaml-designer-in-visual-studio). For information about how to build your own simple UI, see the "To create a WPF application" and "To design a simple WPF MainWindow" sections of [Walkthrough: Accessing the Web by Using Async and Await](../../programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md). 4. Replace the code in MainWindow.xaml.vb with the following code. diff --git a/docs/visual-basic/language-reference/error-messages/can-t-create-necessary-temporary-file.md b/docs/visual-basic/language-reference/error-messages/can-t-create-necessary-temporary-file.md index b604cba57a2a1..041be412dd8a9 100644 --- a/docs/visual-basic/language-reference/error-messages/can-t-create-necessary-temporary-file.md +++ b/docs/visual-basic/language-reference/error-messages/can-t-create-necessary-temporary-file.md @@ -20,4 +20,4 @@ Either the drive is full that contains the directory specified by the TEMP envir ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/cannot-create-activex-component.md b/docs/visual-basic/language-reference/error-messages/cannot-create-activex-component.md index 92134fe280c6c..5218f94ddd120 100644 --- a/docs/visual-basic/language-reference/error-messages/cannot-create-activex-component.md +++ b/docs/visual-basic/language-reference/error-messages/cannot-create-activex-component.md @@ -14,5 +14,5 @@ You tried to place an ActiveX control on a form at design time or add a form to ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) - [Talk to Us](/visualstudio/ide/feedback-options) diff --git a/docs/visual-basic/language-reference/error-messages/class-does-not-support-automation-or-does-not-support-expected-interface.md b/docs/visual-basic/language-reference/error-messages/class-does-not-support-automation-or-does-not-support-expected-interface.md index 207551b7d9316..7340896d7bcad 100644 --- a/docs/visual-basic/language-reference/error-messages/class-does-not-support-automation-or-does-not-support-expected-interface.md +++ b/docs/visual-basic/language-reference/error-messages/class-does-not-support-automation-or-does-not-support-expected-interface.md @@ -16,5 +16,5 @@ Either the class you specified in the `GetObject` or `CreateObject` function cal ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) - [Talk to Us](/visualstudio/ide/feedback-options) diff --git a/docs/visual-basic/language-reference/error-messages/class-statement-must-end-with-a-matching-end-class.md b/docs/visual-basic/language-reference/error-messages/class-statement-must-end-with-a-matching-end-class.md index 1b4ddb2ec5cc1..128d15413219c 100644 --- a/docs/visual-basic/language-reference/error-messages/class-statement-must-end-with-a-matching-end-class.md +++ b/docs/visual-basic/language-reference/error-messages/class-statement-must-end-with-a-matching-end-class.md @@ -21,5 +21,5 @@ ms.assetid: 583f3029-bc3a-4e06-866f-92dbecc46f19 ## See also -- [End \ Statement](../../../visual-basic/language-reference/statements/end-keyword-statement.md) -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) +- [End \ Statement](../statements/end-keyword-statement.md) +- [Class Statement](../statements/class-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/constant-expression-not-representable-in-type-typename.md b/docs/visual-basic/language-reference/error-messages/constant-expression-not-representable-in-type-typename.md index f17a50a269ba5..188ea9a35782f 100644 --- a/docs/visual-basic/language-reference/error-messages/constant-expression-not-representable-in-type-typename.md +++ b/docs/visual-basic/language-reference/error-messages/constant-expression-not-representable-in-type-typename.md @@ -19,5 +19,5 @@ You are trying to evaluate a constant that will not fit into the target type, us ## See also -- [Constants Overview](../../../visual-basic/programming-guide/language-features/constants-enums/constants-overview.md) -- [Constants and Enumerations](../../../visual-basic/language-reference/constants-and-enumerations.md) +- [Constants Overview](../../programming-guide/language-features/constants-enums/constants-overview.md) +- [Constants and Enumerations](../constants-and-enumerations.md) diff --git a/docs/visual-basic/language-reference/error-messages/constants-must-be-of-an-intrinsic-or-enumerated-type.md b/docs/visual-basic/language-reference/error-messages/constants-must-be-of-an-intrinsic-or-enumerated-type.md index 557fa825267e9..0f7706466b4ab 100644 --- a/docs/visual-basic/language-reference/error-messages/constants-must-be-of-an-intrinsic-or-enumerated-type.md +++ b/docs/visual-basic/language-reference/error-messages/constants-must-be-of-an-intrinsic-or-enumerated-type.md @@ -23,6 +23,6 @@ You have attempted to declare a constant as a class, structure, or array type, o ## See also -- [Constants and Enumerations](../../../visual-basic/language-reference/constants-and-enumerations.md) -- [Data Types](../../../visual-basic/programming-guide/language-features/data-types/index.md) -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) +- [Constants and Enumerations](../constants-and-enumerations.md) +- [Data Types](../../programming-guide/language-features/data-types/index.md) +- [Data Types](../data-types/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/constructor-name-cannot-call-itself.md b/docs/visual-basic/language-reference/error-messages/constructor-name-cannot-call-itself.md index 5960e34ce4d6c..b6392a94f63ec 100644 --- a/docs/visual-basic/language-reference/error-messages/constructor-name-cannot-call-itself.md +++ b/docs/visual-basic/language-reference/error-messages/constructor-name-cannot-call-itself.md @@ -23,4 +23,4 @@ A `Sub New` procedure in a class or structure calls itself. ## See also -- [Object Lifetime: How Objects Are Created and Destroyed](../../../visual-basic/programming-guide/language-features/objects-and-classes/object-lifetime-how-objects-are-created-and-destroyed.md) +- [Object Lifetime: How Objects Are Created and Destroyed](../../programming-guide/language-features/objects-and-classes/object-lifetime-how-objects-are-created-and-destroyed.md) diff --git a/docs/visual-basic/language-reference/error-messages/copying-the-value-of-byref-parameter-back-to-the-matching-argument-narrows.md b/docs/visual-basic/language-reference/error-messages/copying-the-value-of-byref-parameter-back-to-the-matching-argument-narrows.md index 0850e3d25cf49..599b9a1af720e 100644 --- a/docs/visual-basic/language-reference/error-messages/copying-the-value-of-byref-parameter-back-to-the-matching-argument-narrows.md +++ b/docs/visual-basic/language-reference/error-messages/copying-the-value-of-byref-parameter-back-to-the-matching-argument-narrows.md @@ -13,7 +13,7 @@ A procedure is called with an argument that widens to the corresponding paramete When you define a class or structure, you can define one or more conversion operators to convert that class or structure type to other types. You can also define reverse conversion operators to convert those other types back to your class or structure type. When you use your class or structure type in a procedure call, Visual Basic can use these conversion operators to convert the type of an argument to the type of its corresponding parameter. - If you pass the argument [ByRef](../../../visual-basic/language-reference/modifiers/byref.md), Visual Basic sometimes copies the argument value into a local variable in the procedure instead of passing a reference. In such a case, when the procedure returns, Visual Basic must then copy the local variable value back into the argument in the calling code. + If you pass the argument [ByRef](../modifiers/byref.md), Visual Basic sometimes copies the argument value into a local variable in the procedure instead of passing a reference. In such a case, when the procedure returns, Visual Basic must then copy the local variable value back into the argument in the calling code. If a `ByRef` argument value is copied into the procedure and the argument and parameter are of the same type, no conversion is necessary. But if the types are different, Visual Basic must convert in both directions. If one of the types is your class or structure type, Visual Basic must convert it both to and from the other type. If one of these conversions is widening, the reverse conversion might be narrowing. @@ -23,18 +23,18 @@ A procedure is called with an argument that widens to the corresponding paramete - If possible, use a calling argument of the same type as the procedure parameter, so Visual Basic does not need to do any conversion. -- If you need to call the procedure with an argument type different from the parameter type but do not need to return a value into the calling argument, define the parameter to be [ByVal](../../../visual-basic/language-reference/modifiers/byval.md) instead of `ByRef`. +- If you need to call the procedure with an argument type different from the parameter type but do not need to return a value into the calling argument, define the parameter to be [ByVal](../modifiers/byval.md) instead of `ByRef`. -- If you need to return a value into the calling argument, define the reverse conversion operator as [Widening](../../../visual-basic/language-reference/modifiers/widening.md), if possible. +- If you need to return a value into the calling argument, define the reverse conversion operator as [Widening](../modifiers/widening.md), if possible. ## See also -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Procedure Parameters and Arguments](../../../visual-basic/programming-guide/language-features/procedures/procedure-parameters-and-arguments.md) -- [Passing Arguments by Value and by Reference](../../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) -- [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md) -- [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) -- [How to: Define an Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-an-operator.md) -- [How to: Define a Conversion Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) -- [Type Conversions in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/type-conversions.md) -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Procedure Parameters and Arguments](../../programming-guide/language-features/procedures/procedure-parameters-and-arguments.md) +- [Passing Arguments by Value and by Reference](../../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md) +- [Operator Statement](../statements/operator-statement.md) +- [How to: Define an Operator](../../programming-guide/language-features/procedures/how-to-define-an-operator.md) +- [How to: Define a Conversion Operator](../../programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) +- [Type Conversions in Visual Basic](../../programming-guide/language-features/data-types/type-conversions.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) diff --git a/docs/visual-basic/language-reference/error-messages/custom-modifier-is-not-valid-on-events-declared-without-explicit-delegate-types.md b/docs/visual-basic/language-reference/error-messages/custom-modifier-is-not-valid-on-events-declared-without-explicit-delegate-types.md index 197b762e482ad..c0af166eaa687 100644 --- a/docs/visual-basic/language-reference/error-messages/custom-modifier-is-not-valid-on-events-declared-without-explicit-delegate-types.md +++ b/docs/visual-basic/language-reference/error-messages/custom-modifier-is-not-valid-on-events-declared-without-explicit-delegate-types.md @@ -36,6 +36,6 @@ Unlike a non-custom event, a `Custom Event` declaration requires an `As` clause ## See also -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [Event Statement](../statements/event-statement.md) +- [Delegate Statement](../statements/delegate-statement.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/data-type-s-of-the-type-parameter-s-cannot-be-inferred-from-these-arguments.md b/docs/visual-basic/language-reference/error-messages/data-type-s-of-the-type-parameter-s-cannot-be-inferred-from-these-arguments.md index 646ae76892973..2528efdcf2aee 100644 --- a/docs/visual-basic/language-reference/error-messages/data-type-s-of-the-type-parameter-s-cannot-be-inferred-from-these-arguments.md +++ b/docs/visual-basic/language-reference/error-messages/data-type-s-of-the-type-parameter-s-cannot-be-inferred-from-these-arguments.md @@ -54,6 +54,6 @@ You may be able to specify a data type for the type parameter or parameters inst ## See also -- [Relaxed Delegate Conversion](../../../visual-basic/programming-guide/language-features/delegates/relaxed-delegate-conversion.md) -- [Generic Procedures in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-procedures.md) -- [Type Conversions in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/type-conversions.md) +- [Relaxed Delegate Conversion](../../programming-guide/language-features/delegates/relaxed-delegate-conversion.md) +- [Generic Procedures in Visual Basic](../../programming-guide/language-features/data-types/generic-procedures.md) +- [Type Conversions in Visual Basic](../../programming-guide/language-features/data-types/type-conversions.md) diff --git a/docs/visual-basic/language-reference/error-messages/declaration-expected.md b/docs/visual-basic/language-reference/error-messages/declaration-expected.md index c4d07fdf485ef..1b96e9646e902 100644 --- a/docs/visual-basic/language-reference/error-messages/declaration-expected.md +++ b/docs/visual-basic/language-reference/error-messages/declaration-expected.md @@ -25,5 +25,5 @@ A nondeclarative statement, such as an assignment or loop statement, occurs outs ## See also -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Dim Statement](../statements/dim-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/default-property-propertyname1-conflicts-with-default-property-propertyname2.md b/docs/visual-basic/language-reference/error-messages/default-property-propertyname1-conflicts-with-default-property-propertyname2.md index 4ab8021a3b299..dc2e0dfaa7587 100644 --- a/docs/visual-basic/language-reference/error-messages/default-property-propertyname1-conflicts-with-default-property-propertyname2.md +++ b/docs/visual-basic/language-reference/error-messages/default-property-propertyname1-conflicts-with-default-property-propertyname2.md @@ -21,5 +21,5 @@ A property is declared with the same name as a property defined in the base clas ## See also -- [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) -- [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md) +- [Shadows](../modifiers/shadows.md) +- [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md) diff --git a/docs/visual-basic/language-reference/error-messages/delegate-class-classname-has-no-invoke-method.md b/docs/visual-basic/language-reference/error-messages/delegate-class-classname-has-no-invoke-method.md index 1a7cee3922259..4a89fd0a9c935 100644 --- a/docs/visual-basic/language-reference/error-messages/delegate-class-classname-has-no-invoke-method.md +++ b/docs/visual-basic/language-reference/error-messages/delegate-class-classname-has-no-invoke-method.md @@ -21,7 +21,7 @@ A call to `Invoke` through a delegate has failed because `Invoke` is not impleme ## See also -- [Delegates](../../../visual-basic/programming-guide/language-features/delegates/index.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) -- [AddressOf Operator](../../../visual-basic/language-reference/operators/addressof-operator.md) -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) +- [Delegates](../../programming-guide/language-features/delegates/index.md) +- [Delegate Statement](../statements/delegate-statement.md) +- [AddressOf Operator](../operators/addressof-operator.md) +- [Dim Statement](../statements/dim-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/derived-classes-cannot-raise-base-class-events.md b/docs/visual-basic/language-reference/error-messages/derived-classes-cannot-raise-base-class-events.md index 9bb595d3875f9..a648da16bb6a3 100644 --- a/docs/visual-basic/language-reference/error-messages/derived-classes-cannot-raise-base-class-events.md +++ b/docs/visual-basic/language-reference/error-messages/derived-classes-cannot-raise-base-class-events.md @@ -19,5 +19,5 @@ An event can be raised only from the declaration space in which it is declared. ## See also -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [RaiseEvent Statement](../../../visual-basic/language-reference/statements/raiseevent-statement.md) +- [Event Statement](../statements/event-statement.md) +- [RaiseEvent Statement](../statements/raiseevent-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/device-i-o-error.md b/docs/visual-basic/language-reference/error-messages/device-i-o-error.md index 8576e7cfa93ca..7b31c5db30956 100644 --- a/docs/visual-basic/language-reference/error-messages/device-i-o-error.md +++ b/docs/visual-basic/language-reference/error-messages/device-i-o-error.md @@ -14,4 +14,4 @@ An input or output error occurred while your program was using a device such as ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/elementname-is-obsolete-visual-basic-warning.md b/docs/visual-basic/language-reference/error-messages/elementname-is-obsolete-visual-basic-warning.md index 9103f233d050c..903878ee9a466 100644 --- a/docs/visual-basic/language-reference/error-messages/elementname-is-obsolete-visual-basic-warning.md +++ b/docs/visual-basic/language-reference/error-messages/elementname-is-obsolete-visual-basic-warning.md @@ -23,4 +23,4 @@ A statement attempts to access a programming element which has been marked with ## See also -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/elseif-must-be-preceded-by-a-matching-if-or-elseif.md b/docs/visual-basic/language-reference/error-messages/elseif-must-be-preceded-by-a-matching-if-or-elseif.md index 586cc8ab7b45b..e65af4918e654 100644 --- a/docs/visual-basic/language-reference/error-messages/elseif-must-be-preceded-by-a-matching-if-or-elseif.md +++ b/docs/visual-basic/language-reference/error-messages/elseif-must-be-preceded-by-a-matching-if-or-elseif.md @@ -23,4 +23,4 @@ ms.assetid: 5215585e-2efa-485a-9efe-9833a1cc83a0 ## See also -- [#If...Then...#Else Directives](../../../visual-basic/language-reference/directives/if-then-else-directives.md) +- [#If...Then...#Else Directives](../directives/if-then-else-directives.md) diff --git a/docs/visual-basic/language-reference/error-messages/end-of-statement-expected.md b/docs/visual-basic/language-reference/error-messages/end-of-statement-expected.md index e1f11e6f965d7..eadf7420bdc72 100644 --- a/docs/visual-basic/language-reference/error-messages/end-of-statement-expected.md +++ b/docs/visual-basic/language-reference/error-messages/end-of-statement-expected.md @@ -23,5 +23,5 @@ The statement is syntactically complete, but an additional programming element f ## See also -- [How to: Break and Combine Statements in Code](../../../visual-basic/programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [How to: Break and Combine Statements in Code](../../programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/error-messages/error-in-loading-dll.md b/docs/visual-basic/language-reference/error-messages/error-in-loading-dll.md index 44a87579e5f80..7eb28a5b86a21 100644 --- a/docs/visual-basic/language-reference/error-messages/error-in-loading-dll.md +++ b/docs/visual-basic/language-reference/error-messages/error-in-loading-dll.md @@ -28,4 +28,4 @@ A dynamic-link library (DLL) is a library specified in the `Lib` clause of a `De ## See also -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Declare Statement](../statements/declare-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/errors-occurred-while-compiling-the-xml-schemas-in-the-project.md b/docs/visual-basic/language-reference/error-messages/errors-occurred-while-compiling-the-xml-schemas-in-the-project.md index a839fb1864a9d..a8f1b75e90eea 100644 --- a/docs/visual-basic/language-reference/error-messages/errors-occurred-while-compiling-the-xml-schemas-in-the-project.md +++ b/docs/visual-basic/language-reference/error-messages/errors-occurred-while-compiling-the-xml-schemas-in-the-project.md @@ -28,4 +28,4 @@ Errors occurred while compiling the XML schemas in the project. Because of this, ## See also - [Error List Window](/visualstudio/ide/reference/error-list-window) -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/event-eventname1-cannot-implement-event-eventname2-on-interface.md b/docs/visual-basic/language-reference/error-messages/event-eventname1-cannot-implement-event-eventname2-on-interface.md index d6931f6db0d4c..e91db58bd1a78 100644 --- a/docs/visual-basic/language-reference/error-messages/event-eventname1-cannot-implement-event-eventname2-on-interface.md +++ b/docs/visual-basic/language-reference/error-messages/event-eventname1-cannot-implement-event-eventname2-on-interface.md @@ -23,6 +23,6 @@ Visual Basic cannot implement an event because the delegate type of the event do ## See also -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [Event Statement](../statements/event-statement.md) +- [Delegate Statement](../statements/delegate-statement.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/eventname-is-an-event-and-cannot-be-called-directly.md b/docs/visual-basic/language-reference/error-messages/eventname-is-an-event-and-cannot-be-called-directly.md index 0c17503d5c355..b3dd58feff7eb 100644 --- a/docs/visual-basic/language-reference/error-messages/eventname-is-an-event-and-cannot-be-called-directly.md +++ b/docs/visual-basic/language-reference/error-messages/eventname-is-an-event-and-cannot-be-called-directly.md @@ -21,4 +21,4 @@ ms.assetid: 4dcfcb8d-a9fa-46a7-a034-29d9ff3a59b3 ## See also -- [RaiseEvent Statement](../../../visual-basic/language-reference/statements/raiseevent-statement.md) +- [RaiseEvent Statement](../statements/raiseevent-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/events-cannot-be-declared-with-a-delegate-type-that-has-a-return-type.md b/docs/visual-basic/language-reference/error-messages/events-cannot-be-declared-with-a-delegate-type-that-has-a-return-type.md index 0e5bdc00e26dc..286905d954c7a 100644 --- a/docs/visual-basic/language-reference/error-messages/events-cannot-be-declared-with-a-delegate-type-that-has-a-return-type.md +++ b/docs/visual-basic/language-reference/error-messages/events-cannot-be-declared-with-a-delegate-type-that-has-a-return-type.md @@ -19,4 +19,4 @@ A delegate was specified for a function procedure. ## See also -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/events-of-shared-withevents-variables-cannot-be-handled-by-non-shared-methods.md b/docs/visual-basic/language-reference/error-messages/events-of-shared-withevents-variables-cannot-be-handled-by-non-shared-methods.md index d6994f8c29b7c..799e383090c54 100644 --- a/docs/visual-basic/language-reference/error-messages/events-of-shared-withevents-variables-cannot-be-handled-by-non-shared-methods.md +++ b/docs/visual-basic/language-reference/error-messages/events-of-shared-withevents-variables-cannot-be-handled-by-non-shared-methods.md @@ -19,5 +19,5 @@ A variable declared with the `Shared` modifier is a shared variable. A shared va ## See also -- [Shared](../../../visual-basic/language-reference/modifiers/shared.md) -- [WithEvents](../../../visual-basic/language-reference/modifiers/withevents.md) +- [Shared](../modifiers/shared.md) +- [WithEvents](../modifiers/withevents.md) diff --git a/docs/visual-basic/language-reference/error-messages/expression-cannot-be-used-as-a-type-constraint.md b/docs/visual-basic/language-reference/error-messages/expression-cannot-be-used-as-a-type-constraint.md index 5630d113403a8..ef994f14debe4 100644 --- a/docs/visual-basic/language-reference/error-messages/expression-cannot-be-used-as-a-type-constraint.md +++ b/docs/visual-basic/language-reference/error-messages/expression-cannot-be-used-as-a-type-constraint.md @@ -35,10 +35,10 @@ A constraint list includes an expression that does not represent a valid constra - If the expression does not qualify for the preceding list of requirements, remove it from the constraint list. -- If the expression refers to an interface or class, verify that the compiler has access to that interface or class. You might need to qualify its name, and you might need to add a reference to your project. For more information, see "References to Projects" in [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md). +- If the expression refers to an interface or class, verify that the compiler has access to that interface or class. You might need to qualify its name, and you might need to add a reference to your project. For more information, see "References to Projects" in [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md). ## See also -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [Value Types and Reference Types](../../../visual-basic/programming-guide/language-features/data-types/value-types-and-reference-types.md) -- [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [Value Types and Reference Types](../../programming-guide/language-features/data-types/value-types-and-reference-types.md) +- [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md) diff --git a/docs/visual-basic/language-reference/error-messages/expression-does-not-produce-a-value.md b/docs/visual-basic/language-reference/error-messages/expression-does-not-produce-a-value.md index c2c7884e77888..a98666313e968 100644 --- a/docs/visual-basic/language-reference/error-messages/expression-does-not-produce-a-value.md +++ b/docs/visual-basic/language-reference/error-messages/expression-does-not-produce-a-value.md @@ -19,4 +19,4 @@ You have tried to use an expression that does not produce a value in a value-pro ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/expression-has-the-type-typename-which-is-a-restricted-type.md b/docs/visual-basic/language-reference/error-messages/expression-has-the-type-typename-which-is-a-restricted-type.md index fd1c5e84d2b86..486900f58770b 100644 --- a/docs/visual-basic/language-reference/error-messages/expression-has-the-type-typename-which-is-a-restricted-type.md +++ b/docs/visual-basic/language-reference/error-messages/expression-has-the-type-typename-which-is-a-restricted-type.md @@ -27,4 +27,4 @@ An expression evaluates to a type that cannot be boxed by the common language ru ## See also -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) diff --git a/docs/visual-basic/language-reference/error-messages/expression-is-a-value-and-therefore-cannot-be-the-target-of-an-assignment.md b/docs/visual-basic/language-reference/error-messages/expression-is-a-value-and-therefore-cannot-be-the-target-of-an-assignment.md index d78683391ab9f..042f884add60f 100644 --- a/docs/visual-basic/language-reference/error-messages/expression-is-a-value-and-therefore-cannot-be-the-target-of-an-assignment.md +++ b/docs/visual-basic/language-reference/error-messages/expression-is-a-value-and-therefore-cannot-be-the-target-of-an-assignment.md @@ -54,6 +54,6 @@ exitButton.Location = exitLocation ## See also -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) -- [Troubleshooting Procedures](../../../visual-basic/programming-guide/language-features/procedures/troubleshooting-procedures.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) +- [Statements](../../programming-guide/language-features/statements.md) +- [Troubleshooting Procedures](../../programming-guide/language-features/procedures/troubleshooting-procedures.md) diff --git a/docs/visual-basic/language-reference/error-messages/expression-of-type-type-is-not-queryable.md b/docs/visual-basic/language-reference/error-messages/expression-of-type-type-is-not-queryable.md index 7c191d4572eee..9830fee57b28b 100644 --- a/docs/visual-basic/language-reference/error-messages/expression-of-type-type-is-not-queryable.md +++ b/docs/visual-basic/language-reference/error-messages/expression-of-type-type-is-not-queryable.md @@ -32,9 +32,9 @@ Expression of type \ is not queryable. Make sure you are not missing an as - - - -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [LINQ](../../../visual-basic/programming-guide/language-features/linq/index.md) -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) -- [References and the Imports Statement](../../../visual-basic/programming-guide/program-structure/references-and-the-imports-statement.md) -- [Imports Statement (.NET Namespace and Type)](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [LINQ](../../programming-guide/language-features/linq/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) +- [References and the Imports Statement](../../programming-guide/program-structure/references-and-the-imports-statement.md) +- [Imports Statement (.NET Namespace and Type)](../statements/imports-statement-net-namespace-and-type.md) - [References Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/references-page-project-designer-visual-basic) diff --git a/docs/visual-basic/language-reference/error-messages/expression-recursively-calls-the-containing-property-propertyname.md b/docs/visual-basic/language-reference/error-messages/expression-recursively-calls-the-containing-property-propertyname.md index 502a8680c9a1a..d05f7c51854dc 100644 --- a/docs/visual-basic/language-reference/error-messages/expression-recursively-calls-the-containing-property-propertyname.md +++ b/docs/visual-basic/language-reference/error-messages/expression-recursively-calls-the-containing-property-propertyname.md @@ -13,7 +13,7 @@ A statement in the `Set` procedure of a property definition stores a value into The recommended approach to holding the value of a property is to define a `Private` variable in the property's container and use it in both the `Get` and `Set` procedures. The `Set` procedure should then store the incoming value in this `Private` variable. - The `Get` procedure behaves like a `Function` procedure, so it can assign a value to the property name and return control by encountering the `End Get` statement. The recommended approach, however, is to include the `Private` variable as the value in a [Return Statement](../../../visual-basic/language-reference/statements/return-statement.md). + The `Get` procedure behaves like a `Function` procedure, so it can assign a value to the property name and return control by encountering the `End Get` statement. The recommended approach, however, is to include the `Private` variable as the value in a [Return Statement](../statements/return-statement.md). The `Set` procedure behaves like a `Sub` procedure, which does not return a value. Therefore, the procedure or property name has no special meaning within a `Set` procedure, and you cannot store a value into it. @@ -59,6 +59,6 @@ End Class ## See also -- [Property Procedures](../../../visual-basic/programming-guide/language-features/procedures/property-procedures.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Set Statement](../../../visual-basic/language-reference/statements/set-statement.md) +- [Property Procedures](../../programming-guide/language-features/procedures/property-procedures.md) +- [Property Statement](../statements/property-statement.md) +- [Set Statement](../statements/set-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/expression-too-complex.md b/docs/visual-basic/language-reference/error-messages/expression-too-complex.md index 050fe255c61d5..fd3e2b0b508fa 100644 --- a/docs/visual-basic/language-reference/error-messages/expression-too-complex.md +++ b/docs/visual-basic/language-reference/error-messages/expression-too-complex.md @@ -14,4 +14,4 @@ A floating-point expression contains too many nested subexpressions. ## See also -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/extension-attribute-can-be-applied-only-to-module-sub-or-function-declarations.md b/docs/visual-basic/language-reference/error-messages/extension-attribute-can-be-applied-only-to-module-sub-or-function-declarations.md index 1991d62b06e2d..79de187ab45c6 100644 --- a/docs/visual-basic/language-reference/error-messages/extension-attribute-can-be-applied-only-to-module-sub-or-function-declarations.md +++ b/docs/visual-basic/language-reference/error-messages/extension-attribute-can-be-applied-only-to-module-sub-or-function-declarations.md @@ -40,6 +40,6 @@ End Namespace ## See also -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) -- [Extension Methods](../../../visual-basic/programming-guide/language-features/procedures/extension-methods.md) -- [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) +- [Extension Methods](../../programming-guide/language-features/procedures/extension-methods.md) +- [Module Statement](../statements/module-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/file-is-too-large-to-read-into-a-byte-array.md b/docs/visual-basic/language-reference/error-messages/file-is-too-large-to-read-into-a-byte-array.md index ebb516a9d47ef..c96cc350f786d 100644 --- a/docs/visual-basic/language-reference/error-messages/file-is-too-large-to-read-into-a-byte-array.md +++ b/docs/visual-basic/language-reference/error-messages/file-is-too-large-to-read-into-a-byte-array.md @@ -8,11 +8,11 @@ The size of the file you are attempting to read into a byte array exceeds 4 GB. ## To correct this error -- Use a to read the file. For more information, see [Basics of .NET Framework File I/O and the File System (Visual Basic)](../../../visual-basic/developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md). +- Use a to read the file. For more information, see [Basics of .NET Framework File I/O and the File System (Visual Basic)](../../developing-apps/programming/drives-directories-files/basics-of-net-framework-file-io-and-the-file-system.md). ## See also - - -- [File Access with Visual Basic](../../../visual-basic/developing-apps/programming/drives-directories-files/file-access.md) -- [How to: Read Text from Files with a StreamReader](../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-text-from-files-with-a-streamreader.md) +- [File Access with Visual Basic](../../developing-apps/programming/drives-directories-files/file-access.md) +- [How to: Read Text from Files with a StreamReader](../../developing-apps/programming/drives-directories-files/how-to-read-text-from-files-with-a-streamreader.md) diff --git a/docs/visual-basic/language-reference/error-messages/file-name-or-class-name-not-found-during-automation-operation.md b/docs/visual-basic/language-reference/error-messages/file-name-or-class-name-not-found-during-automation-operation.md index 4793bb2ad0931..81f1e8c65e9ee 100644 --- a/docs/visual-basic/language-reference/error-messages/file-name-or-class-name-not-found-during-automation-operation.md +++ b/docs/visual-basic/language-reference/error-messages/file-name-or-class-name-not-found-during-automation-operation.md @@ -14,4 +14,4 @@ The name specified for file name or class in a call to the `GetObject` function ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/file-not-found-visual-basic-run-time-error.md b/docs/visual-basic/language-reference/error-messages/file-not-found-visual-basic-run-time-error.md index 9f42263f6f6ac..fa671b7dfcf62 100644 --- a/docs/visual-basic/language-reference/error-messages/file-not-found-visual-basic-run-time-error.md +++ b/docs/visual-basic/language-reference/error-messages/file-not-found-visual-basic-run-time-error.md @@ -20,4 +20,4 @@ The file was not found where specified. The error has the following possible cau ## See also -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Declare Statement](../statements/declare-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/first-operand-in-a-binary-if-expression-must-be-nullable-or-a-reference-type.md b/docs/visual-basic/language-reference/error-messages/first-operand-in-a-binary-if-expression-must-be-nullable-or-a-reference-type.md index 97f11b67a906d..d07304e2aa6bb 100644 --- a/docs/visual-basic/language-reference/error-messages/first-operand-in-a-binary-if-expression-must-be-nullable-or-a-reference-type.md +++ b/docs/visual-basic/language-reference/error-messages/first-operand-in-a-binary-if-expression-must-be-nullable-or-a-reference-type.md @@ -49,6 +49,6 @@ Console.WriteLine(If(booleanVar, "Test returns True.", "Test returns False.")) ## See also -- [If Operator](../../../visual-basic/language-reference/operators/if-operator.md) -- [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) -- [Nullable Value Types](../../../visual-basic/programming-guide/language-features/data-types/nullable-value-types.md) +- [If Operator](../operators/if-operator.md) +- [If...Then...Else Statement](../statements/if-then-else-statement.md) +- [Nullable Value Types](../../programming-guide/language-features/data-types/nullable-value-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/first-statement-of-sub-new-must-be-explicit-call-to-mybase-new-or-myclass-new.md b/docs/visual-basic/language-reference/error-messages/first-statement-of-sub-new-must-be-explicit-call-to-mybase-new-or-myclass-new.md index d5f159406047b..45df67bf37f2b 100644 --- a/docs/visual-basic/language-reference/error-messages/first-statement-of-sub-new-must-be-explicit-call-to-mybase-new-or-myclass-new.md +++ b/docs/visual-basic/language-reference/error-messages/first-statement-of-sub-new-must-be-explicit-call-to-mybase-new-or-myclass-new.md @@ -25,4 +25,4 @@ A class constructor does not explicitly call a base class constructor, and the i ## See also -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/first-statement-of-this-sub-new-must-be-a-call-to-mybase-new-or-myclass-new.md b/docs/visual-basic/language-reference/error-messages/first-statement-of-this-sub-new-must-be-a-call-to-mybase-new-or-myclass-new.md index 80637c1965c02..d49ccb54fb608 100644 --- a/docs/visual-basic/language-reference/error-messages/first-statement-of-this-sub-new-must-be-a-call-to-mybase-new-or-myclass-new.md +++ b/docs/visual-basic/language-reference/error-messages/first-statement-of-this-sub-new-must-be-a-call-to-mybase-new-or-myclass-new.md @@ -23,4 +23,4 @@ First statement of this 'Sub New' must be a call to 'MyBase.New' or 'MyClass.New ## See also -- [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md) +- [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md) diff --git a/docs/visual-basic/language-reference/error-messages/for-each-on-type-typename-is-ambiguous.md b/docs/visual-basic/language-reference/error-messages/for-each-on-type-typename-is-ambiguous.md index c46fb49ed34bb..4e64d5c33e2ee 100644 --- a/docs/visual-basic/language-reference/error-messages/for-each-on-type-typename-is-ambiguous.md +++ b/docs/visual-basic/language-reference/error-messages/for-each-on-type-typename-is-ambiguous.md @@ -17,9 +17,9 @@ A `For Each` statement specifies an iterator variable that has more than one method you want to use. +- Use [DirectCast Operator](../operators/directcast-operator.md) or [TryCast Operator](../operators/trycast-operator.md) to cast the iterator variable type to the interface defining the method you want to use. ## See also -- [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md) -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) +- [For Each...Next Statement](../statements/for-each-next-statement.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/function-evaluation-is-disabled.md b/docs/visual-basic/language-reference/error-messages/function-evaluation-is-disabled.md index 87f08676d6001..ad376b78faaa4 100644 --- a/docs/visual-basic/language-reference/error-messages/function-evaluation-is-disabled.md +++ b/docs/visual-basic/language-reference/error-messages/function-evaluation-is-disabled.md @@ -13,9 +13,9 @@ Function evaluation is disabled because a previous function evaluation timed out In the Visual Studio debugger, an expression specifies a procedure call, but another evaluation has timed out. - Possible causes for a procedure call to time out include an infinite loop or *endless loop*. For more information, see [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md). + Possible causes for a procedure call to time out include an infinite loop or *endless loop*. For more information, see [For...Next Statement](../statements/for-next-statement.md). - A special case of an infinite loop is *recursion*. For more information, see [Recursive Procedures](../../../visual-basic/programming-guide/language-features/procedures/recursive-procedures.md). + A special case of an infinite loop is *recursion*. For more information, see [Recursive Procedures](../../programming-guide/language-features/procedures/recursive-procedures.md). **Error ID:** BC30957 diff --git a/docs/visual-basic/language-reference/error-messages/function-procedurename-doesn-t-return-a-value-on-all-code-paths.md b/docs/visual-basic/language-reference/error-messages/function-procedurename-doesn-t-return-a-value-on-all-code-paths.md index 4d1b510004461..333578d2785c2 100644 --- a/docs/visual-basic/language-reference/error-messages/function-procedurename-doesn-t-return-a-value-on-all-code-paths.md +++ b/docs/visual-basic/language-reference/error-messages/function-procedurename-doesn-t-return-a-value-on-all-code-paths.md @@ -15,13 +15,13 @@ Function '\' doesn't return a value on all code paths. Are you mi You can return a value from a `Function` procedure in any of the following ways: -- Include the value in a [Return Statement](../../../visual-basic/language-reference/statements/return-statement.md). +- Include the value in a [Return Statement](../statements/return-statement.md). - Assign the value to the `Function` procedure name and then perform an `Exit Function` statement. - Assign the value to the `Function` procedure name and then perform the `End Function` statement. - If control passes to `Exit Function` or `End Function` and you have not assigned any value to the procedure name, the procedure returns the default value of the return data type. For more information, see "Behavior" in [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md). + If control passes to `Exit Function` or `End Function` and you have not assigned any value to the procedure name, the procedure returns the default value of the return data type. For more information, see "Behavior" in [Function Statement](../statements/function-statement.md). By default, this message is a warning. For more information on hiding warnings or treating warnings as errors, see [Configuring Warnings in Visual Basic](/visualstudio/ide/configuring-warnings-in-visual-basic). @@ -35,6 +35,6 @@ Function '\' doesn't return a value on all code paths. Are you mi ## See also -- [Function Procedures](../../../visual-basic/programming-guide/language-features/procedures/function-procedures.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Procedures](../../programming-guide/language-features/procedures/function-procedures.md) +- [Function Statement](../statements/function-statement.md) - [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) diff --git a/docs/visual-basic/language-reference/error-messages/functionname-is-not-declared-smart-device-visual-basic-compiler-error.md b/docs/visual-basic/language-reference/error-messages/functionname-is-not-declared-smart-device-visual-basic-compiler-error.md index da549b03c1eff..b287f159665c0 100644 --- a/docs/visual-basic/language-reference/error-messages/functionname-is-not-declared-smart-device-visual-basic-compiler-error.md +++ b/docs/visual-basic/language-reference/error-messages/functionname-is-not-declared-smart-device-visual-basic-compiler-error.md @@ -20,4 +20,4 @@ ms.assetid: 13918600-6087-40d7-8134-32aa9d3bfda4 ## See also - -- [File Access with Visual Basic](../../../visual-basic/developing-apps/programming/drives-directories-files/file-access.md) +- [File Access with Visual Basic](../../developing-apps/programming/drives-directories-files/file-access.md) diff --git a/docs/visual-basic/language-reference/error-messages/generic-parameters-used-as-optional-parameter-types-must-be-class-constrained.md b/docs/visual-basic/language-reference/error-messages/generic-parameters-used-as-optional-parameter-types-must-be-class-constrained.md index 50f5b86561826..7c0e2f826610d 100644 --- a/docs/visual-basic/language-reference/error-messages/generic-parameters-used-as-optional-parameter-types-must-be-class-constrained.md +++ b/docs/visual-basic/language-reference/error-messages/generic-parameters-used-as-optional-parameter-types-must-be-class-constrained.md @@ -23,9 +23,9 @@ A procedure is declared with an optional parameter that uses a type parameter th ## See also -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [Type List](../../../visual-basic/language-reference/statements/type-list.md) -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) -- [Optional Parameters](../../../visual-basic/programming-guide/language-features/procedures/optional-parameters.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Nothing](../../../visual-basic/language-reference/nothing.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [Type List](../statements/type-list.md) +- [Class Statement](../statements/class-statement.md) +- [Optional Parameters](../../programming-guide/language-features/procedures/optional-parameters.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Nothing](../nothing.md) diff --git a/docs/visual-basic/language-reference/error-messages/get-accessor-of-property-propertyname-is-not-accessible.md b/docs/visual-basic/language-reference/error-messages/get-accessor-of-property-propertyname-is-not-accessible.md index 85b03a78f810a..d4f5e44e7ba1a 100644 --- a/docs/visual-basic/language-reference/error-messages/get-accessor-of-property-propertyname-is-not-accessible.md +++ b/docs/visual-basic/language-reference/error-messages/get-accessor-of-property-propertyname-is-not-accessible.md @@ -11,13 +11,13 @@ ms.assetid: 3c346c32-7669-4b04-841d-7a9df9cb703e # 'Get' accessor of property '\' is not accessible A statement attempts to retrieve the value of a property when it does not have access to the property's `Get` procedure. - If the [Get Statement](../../../visual-basic/language-reference/statements/get-statement.md) is marked with a more restrictive access level than its [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md), an attempt to read the property value could fail in the following cases: + If the [Get Statement](../statements/get-statement.md) is marked with a more restrictive access level than its [Property Statement](../statements/property-statement.md), an attempt to read the property value could fail in the following cases: -- The `Get` statement is marked [Private](../../../visual-basic/language-reference/modifiers/private.md) and the calling code is outside the class or structure in which the property is defined. +- The `Get` statement is marked [Private](../modifiers/private.md) and the calling code is outside the class or structure in which the property is defined. -- The `Get` statement is marked [Protected](../../../visual-basic/language-reference/modifiers/protected.md) and the calling code is not in the class or structure in which the property is defined, nor in a derived class. +- The `Get` statement is marked [Protected](../modifiers/protected.md) and the calling code is not in the class or structure in which the property is defined, nor in a derived class. -- The `Get` statement is marked [Friend](../../../visual-basic/language-reference/modifiers/friend.md) and the calling code is not in the same assembly in which the property is defined. +- The `Get` statement is marked [Friend](../modifiers/friend.md) and the calling code is not in the same assembly in which the property is defined. **Error ID:** BC31103 @@ -29,5 +29,5 @@ A statement attempts to retrieve the value of a property when it does not have a ## See also -- [Property Procedures](../../../visual-basic/programming-guide/language-features/procedures/property-procedures.md) -- [How to: Declare a Property with Mixed Access Levels](../../../visual-basic/programming-guide/language-features/procedures/how-to-declare-a-property-with-mixed-access-levels.md) +- [Property Procedures](../../programming-guide/language-features/procedures/property-procedures.md) +- [How to: Declare a Property with Mixed Access Levels](../../programming-guide/language-features/procedures/how-to-declare-a-property-with-mixed-access-levels.md) diff --git a/docs/visual-basic/language-reference/error-messages/handles-clause-requires-a-withevents-variable-defined.md b/docs/visual-basic/language-reference/error-messages/handles-clause-requires-a-withevents-variable-defined.md index b3e047a465878..cdc38b12bd6a0 100644 --- a/docs/visual-basic/language-reference/error-messages/handles-clause-requires-a-withevents-variable-defined.md +++ b/docs/visual-basic/language-reference/error-messages/handles-clause-requires-a-withevents-variable-defined.md @@ -65,4 +65,4 @@ End Module ## See also -- [Handles](../../../visual-basic/language-reference/statements/handles-clause.md) +- [Handles](../statements/handles-clause.md) diff --git a/docs/visual-basic/language-reference/error-messages/identifier-expected.md b/docs/visual-basic/language-reference/error-messages/identifier-expected.md index 7963a8d582acd..9ec9b67e63268 100644 --- a/docs/visual-basic/language-reference/error-messages/identifier-expected.md +++ b/docs/visual-basic/language-reference/error-messages/identifier-expected.md @@ -21,5 +21,5 @@ A programming element that is not a recognizable declared element name occurs wh ## See also -- [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md) -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) +- [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/identifier-is-too-long.md b/docs/visual-basic/language-reference/error-messages/identifier-is-too-long.md index 0eb5fa4d1fb7a..4bb0cb315711b 100644 --- a/docs/visual-basic/language-reference/error-messages/identifier-is-too-long.md +++ b/docs/visual-basic/language-reference/error-messages/identifier-is-too-long.md @@ -19,4 +19,4 @@ The name, or identifier, of every programming element is limited to 1023 charact ## See also -- [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md) +- [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md) diff --git a/docs/visual-basic/language-reference/error-messages/implicit-conversion-from-typename1-to-typename2-in-copying.md b/docs/visual-basic/language-reference/error-messages/implicit-conversion-from-typename1-to-typename2-in-copying.md index fc94a0a27ce6c..72ec947fc879c 100644 --- a/docs/visual-basic/language-reference/error-messages/implicit-conversion-from-typename1-to-typename2-in-copying.md +++ b/docs/visual-basic/language-reference/error-messages/implicit-conversion-from-typename1-to-typename2-in-copying.md @@ -9,7 +9,7 @@ helpviewer_keywords: ms.assetid: ae48c738-dff8-4c0f-8931-bbb70b2c8b03 --- # Implicit conversion from '\' to '\' in copying the value of 'ByRef' parameter '\' back to the matching argument. -A procedure is called with a [ByRef](../../../visual-basic/language-reference/modifiers/byref.md) argument of a different type than that of its corresponding parameter. +A procedure is called with a [ByRef](../modifiers/byref.md) argument of a different type than that of its corresponding parameter. If you pass an argument `ByRef`, Visual Basic sometimes copies the argument value into a local variable in the procedure instead of passing a reference. In such a case, when the procedure returns, Visual Basic must then copy the local variable value back into the argument in the calling code. @@ -23,11 +23,11 @@ A procedure is called with a [ByRef](../../../visual-basic/language-reference/mo - If possible, use a calling argument of the same type as the procedure parameter, so Visual Basic does not need to do any conversion. -- If you need to call the procedure with an argument type different from the parameter type but do not need to return a value into the calling argument, define the parameter to be [ByVal](../../../visual-basic/language-reference/modifiers/byval.md) instead of `ByRef`. +- If you need to call the procedure with an argument type different from the parameter type but do not need to return a value into the calling argument, define the parameter to be [ByVal](../modifiers/byval.md) instead of `ByRef`. ## See also -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Procedure Parameters and Arguments](../../../visual-basic/programming-guide/language-features/procedures/procedure-parameters-and-arguments.md) -- [Passing Arguments by Value and by Reference](../../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Procedure Parameters and Arguments](../../programming-guide/language-features/procedures/procedure-parameters-and-arguments.md) +- [Passing Arguments by Value and by Reference](../../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) diff --git a/docs/visual-basic/language-reference/error-messages/index.md b/docs/visual-basic/language-reference/error-messages/index.md index a0f156047684f..bc2fe907e8dd0 100644 --- a/docs/visual-basic/language-reference/error-messages/index.md +++ b/docs/visual-basic/language-reference/error-messages/index.md @@ -17,12 +17,12 @@ When you write, compile, or run a Visual Basic application, the following types 3. Run-time errors, which occur when you run an application in Visual Studio or as a stand-alone executable file. - For information about how to troubleshoot a specific error, see [Additional Resources for Visual Basic Programmers](../../../visual-basic/getting-started/additional-resources.md). + For information about how to troubleshoot a specific error, see [Additional Resources for Visual Basic Programmers](../../getting-started/additional-resources.md). ## Run Time Errors If a Visual Basic application tries to perform an action that the system can't execute, a run-time error occurs, and Visual Basic throws an `Exception` object. Visual Basic can generate custom errors of any data type, including `Exception` objects, by using the `Throw` statement. An application can identify the error by displaying the error number and message of a caught exception. If an error isn't caught, the application ends. - The code can trap and examine run-time errors. If you enclose the code that produces the error in a `Try` block, you can catch any thrown error within a matching `Catch` block. For information about how to trap errors at run time and respond to them in your code, see [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md). + The code can trap and examine run-time errors. If you enclose the code that produces the error in a `Try` block, you can catch any thrown error within a matching `Catch` block. For information about how to trap errors at run time and respond to them in your code, see [Try...Catch...Finally Statement](../statements/try-catch-finally-statement.md). ## Compile Time Errors If the Visual Basic compiler encounters a problem in the code, a compile-time error occurs. In the Code Editor, you can easily identify which line of code caused the error because a wavy line appears under that line of code. The error message appears if you either point to the wavy underline or open the **Error List**, which also shows other messages. diff --git a/docs/visual-basic/language-reference/error-messages/initializer-expected.md b/docs/visual-basic/language-reference/error-messages/initializer-expected.md index 9cc9b87ca6170..fbe4c84cc4411 100644 --- a/docs/visual-basic/language-reference/error-messages/initializer-expected.md +++ b/docs/visual-basic/language-reference/error-messages/initializer-expected.md @@ -27,5 +27,5 @@ You have tried to declare an instance of a class by using an object initializer ## See also -- [Object Initializers: Named and Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) -- [How to: Declare an Object by Using an Object Initializer](../../../visual-basic/programming-guide/language-features/objects-and-classes/how-to-declare-an-object-by-using-an-object-initializer.md) +- [Object Initializers: Named and Anonymous Types](../../programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) +- [How to: Declare an Object by Using an Object Initializer](../../programming-guide/language-features/objects-and-classes/how-to-declare-an-object-by-using-an-object-initializer.md) diff --git a/docs/visual-basic/language-reference/error-messages/interfacename-membername-is-already-implemented-by-the-base-class.md b/docs/visual-basic/language-reference/error-messages/interfacename-membername-is-already-implemented-by-the-base-class.md index 315680c66362a..cf11516af1eb6 100644 --- a/docs/visual-basic/language-reference/error-messages/interfacename-membername-is-already-implemented-by-the-base-class.md +++ b/docs/visual-basic/language-reference/error-messages/interfacename-membername-is-already-implemented-by-the-base-class.md @@ -11,7 +11,7 @@ ms.assetid: 658c070a-113e-4bd8-b294-12c243191160 # '\.\' is already implemented by the base class '\'. Re-implementation of \ assumed A property, procedure, or event in a derived class uses an `Implements` clause specifying an interface member that is already implemented in the base class. - A derived class can reimplement an interface member that is implemented by its base class. This is not the same as overriding the base class implementation. For more information, see [Implements](../../../visual-basic/language-reference/statements/implements-clause.md). + A derived class can reimplement an interface member that is implemented by its base class. This is not the same as overriding the base class implementation. For more information, see [Implements](../statements/implements-clause.md). By default, this message is a warning. For information on hiding warnings or treating warnings as errors, see [Configuring Warnings in Visual Basic](/visualstudio/ide/configuring-warnings-in-visual-basic). @@ -25,4 +25,4 @@ A property, procedure, or event in a derived class uses an `Implements` clause s ## See also -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/is-requires-operands-that-have-reference-types.md b/docs/visual-basic/language-reference/error-messages/is-requires-operands-that-have-reference-types.md index 06aa93c08128d..191930de66c5c 100644 --- a/docs/visual-basic/language-reference/error-messages/is-requires-operands-that-have-reference-types.md +++ b/docs/visual-basic/language-reference/error-messages/is-requires-operands-that-have-reference-types.md @@ -19,6 +19,6 @@ The `Is` comparison operator determines whether two object variables refer to th ## See also -- [Is Operator](../../../visual-basic/language-reference/operators/is-operator.md) -- [Like Operator](../../../visual-basic/language-reference/operators/like-operator.md) -- [Comparison Operators](../../../visual-basic/language-reference/operators/comparison-operators.md) +- [Is Operator](../operators/is-operator.md) +- [Like Operator](../operators/like-operator.md) +- [Comparison Operators](../operators/comparison-operators.md) diff --git a/docs/visual-basic/language-reference/error-messages/isnot-operand-of-type-can-only-be-compared-to-nothing.md b/docs/visual-basic/language-reference/error-messages/isnot-operand-of-type-can-only-be-compared-to-nothing.md index b254ffba04e3d..3df82b76578f4 100644 --- a/docs/visual-basic/language-reference/error-messages/isnot-operand-of-type-can-only-be-compared-to-nothing.md +++ b/docs/visual-basic/language-reference/error-messages/isnot-operand-of-type-can-only-be-compared-to-nothing.md @@ -30,5 +30,5 @@ End If ## See also -- [Nullable Value Types](../../../visual-basic/programming-guide/language-features/data-types/nullable-value-types.md) -- [IsNot Operator](../../../visual-basic/language-reference/operators/isnot-operator.md) +- [Nullable Value Types](../../programming-guide/language-features/data-types/nullable-value-types.md) +- [IsNot Operator](../operators/isnot-operator.md) diff --git a/docs/visual-basic/language-reference/error-messages/keyword-is-valid-only-within-an-instance-method.md b/docs/visual-basic/language-reference/error-messages/keyword-is-valid-only-within-an-instance-method.md index ac94bf16c550a..1afcd4ac54b9d 100644 --- a/docs/visual-basic/language-reference/error-messages/keyword-is-valid-only-within-an-instance-method.md +++ b/docs/visual-basic/language-reference/error-messages/keyword-is-valid-only-within-an-instance-method.md @@ -19,6 +19,6 @@ The `Me`, `MyClass`, and `MyBase` keywords refer to specific class instances. Yo ## See also -- [Object Variable Assignment](../../../visual-basic/programming-guide/language-features/variables/object-variable-assignment.md) -- [Me, My, MyBase, and MyClass](../../../visual-basic/programming-guide/program-structure/me-my-mybase-and-myclass.md) -- [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md) +- [Object Variable Assignment](../../programming-guide/language-features/variables/object-variable-assignment.md) +- [Me, My, MyBase, and MyClass](../../programming-guide/program-structure/me-my-mybase-and-myclass.md) +- [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md) diff --git a/docs/visual-basic/language-reference/error-messages/labels-that-are-numbers-must-be-followed-by-colons.md b/docs/visual-basic/language-reference/error-messages/labels-that-are-numbers-must-be-followed-by-colons.md index 43c7b9d83a90e..d20b9a7612305 100644 --- a/docs/visual-basic/language-reference/error-messages/labels-that-are-numbers-must-be-followed-by-colons.md +++ b/docs/visual-basic/language-reference/error-messages/labels-that-are-numbers-must-be-followed-by-colons.md @@ -23,4 +23,4 @@ Line numbers follow the same rules as other kinds of labels, and must contain a ## See also -- [GoTo Statement](../../../visual-basic/language-reference/statements/goto-statement.md) +- [GoTo Statement](../statements/goto-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/lambda-expression-will-not-be-removed-from-this-event-handler.md b/docs/visual-basic/language-reference/error-messages/lambda-expression-will-not-be-removed-from-this-event-handler.md index 9a8d777d1fdf5..42bb03175b683 100644 --- a/docs/visual-basic/language-reference/error-messages/lambda-expression-will-not-be-removed-from-this-event-handler.md +++ b/docs/visual-basic/language-reference/error-messages/lambda-expression-will-not-be-removed-from-this-event-handler.md @@ -81,6 +81,6 @@ End Module ## See also -- [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md) -- [Relaxed Delegate Conversion](../../../visual-basic/programming-guide/language-features/delegates/relaxed-delegate-conversion.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md) +- [Relaxed Delegate Conversion](../../programming-guide/language-features/delegates/relaxed-delegate-conversion.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/lambda-expressions-are-not-valid-in-the-first-expression-of-select-case.md b/docs/visual-basic/language-reference/error-messages/lambda-expressions-are-not-valid-in-the-first-expression-of-select-case.md index a16bd9e14cde4..cba0ee5066495 100644 --- a/docs/visual-basic/language-reference/error-messages/lambda-expressions-are-not-valid-in-the-first-expression-of-select-case.md +++ b/docs/visual-basic/language-reference/error-messages/lambda-expressions-are-not-valid-in-the-first-expression-of-select-case.md @@ -36,6 +36,6 @@ End Select ## See also -- [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md) -- [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) -- [Select...Case Statement](../../../visual-basic/language-reference/statements/select-case-statement.md) +- [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md) +- [If...Then...Else Statement](../statements/if-then-else-statement.md) +- [Select...Case Statement](../statements/select-case-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/late-bound-resolution;-runtime-errors-could-occur.md b/docs/visual-basic/language-reference/error-messages/late-bound-resolution;-runtime-errors-could-occur.md index 1c13055ccd401..c0f2f5612e7f5 100644 --- a/docs/visual-basic/language-reference/error-messages/late-bound-resolution;-runtime-errors-could-occur.md +++ b/docs/visual-basic/language-reference/error-messages/late-bound-resolution;-runtime-errors-could-occur.md @@ -9,7 +9,7 @@ helpviewer_keywords: ms.assetid: 45f552c8-57c6-44c0-97d3-e510119b257a --- # Late bound resolution; runtime errors could occur -An object is assigned to a variable declared to be of the [Object Data Type](../../../visual-basic/language-reference/data-types/object-data-type.md). +An object is assigned to a variable declared to be of the [Object Data Type](../data-types/object-data-type.md). When you declare a variable as `Object`, the compiler must perform *late binding*, which causes extra operations at run time. It also exposes your application to potential run-time errors. For example, if you assign a to the `Object` variable and then try to access the property, the runtime throws a because the class does not expose a `NameTable` property. @@ -25,5 +25,5 @@ An object is assigned to a variable declared to be of the [Object Data Type](../ ## See also -- [Early and Late Binding](../../../visual-basic/programming-guide/language-features/early-late-binding/index.md) -- [Object Variable Declaration](../../../visual-basic/programming-guide/language-features/variables/object-variable-declaration.md) +- [Early and Late Binding](../../programming-guide/language-features/early-late-binding/index.md) +- [Object Variable Declaration](../../programming-guide/language-features/variables/object-variable-declaration.md) diff --git a/docs/visual-basic/language-reference/error-messages/latebound-overload-resolution-cannot-be-applied.md b/docs/visual-basic/language-reference/error-messages/latebound-overload-resolution-cannot-be-applied.md index 7e70b8e6987ab..7f8f752a8b9a0 100644 --- a/docs/visual-basic/language-reference/error-messages/latebound-overload-resolution-cannot-be-applied.md +++ b/docs/visual-basic/language-reference/error-messages/latebound-overload-resolution-cannot-be-applied.md @@ -62,6 +62,6 @@ Each of the preceding lines of code explicitly casts the `Object` variable `o1` ## See also -- [Procedure Overloading](../../../visual-basic/programming-guide/language-features/procedures/procedure-overloading.md) -- [Overload Resolution](../../../visual-basic/programming-guide/language-features/procedures/overload-resolution.md) -- [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) +- [Procedure Overloading](../../programming-guide/language-features/procedures/procedure-overloading.md) +- [Overload Resolution](../../programming-guide/language-features/procedures/overload-resolution.md) +- [CType Function](../functions/ctype-function.md) diff --git a/docs/visual-basic/language-reference/error-messages/leading-period-or-exclamation-point-can-only-appear-inside-a-with-statement.md b/docs/visual-basic/language-reference/error-messages/leading-period-or-exclamation-point-can-only-appear-inside-a-with-statement.md index 96eb4b8d9df0b..f12defd6f0fd8 100644 --- a/docs/visual-basic/language-reference/error-messages/leading-period-or-exclamation-point-can-only-appear-inside-a-with-statement.md +++ b/docs/visual-basic/language-reference/error-messages/leading-period-or-exclamation-point-can-only-appear-inside-a-with-statement.md @@ -21,5 +21,5 @@ A period (.) or exclamation point (!) that is not inside a `With` block occurs w ## See also -- [Special Characters in Code](../../../visual-basic/programming-guide/program-structure/special-characters-in-code.md) -- [With...End With Statement](../../../visual-basic/language-reference/statements/with-end-with-statement.md) +- [Special Characters in Code](../../programming-guide/program-structure/special-characters-in-code.md) +- [With...End With Statement](../statements/with-end-with-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/line-is-too-long.md b/docs/visual-basic/language-reference/error-messages/line-is-too-long.md index 0df39c36c6202..55b412b6e5aef 100644 --- a/docs/visual-basic/language-reference/error-messages/line-is-too-long.md +++ b/docs/visual-basic/language-reference/error-messages/line-is-too-long.md @@ -19,4 +19,4 @@ Source text lines cannot exceed 65535 characters. ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/line-statements-are-no-longer-supported-visual-basic-compiler-error.md b/docs/visual-basic/language-reference/error-messages/line-statements-are-no-longer-supported-visual-basic-compiler-error.md index d77c9b3553c9a..235786d3ecc08 100644 --- a/docs/visual-basic/language-reference/error-messages/line-statements-are-no-longer-supported-visual-basic-compiler-error.md +++ b/docs/visual-basic/language-reference/error-messages/line-statements-are-no-longer-supported-visual-basic-compiler-error.md @@ -23,4 +23,4 @@ Line statements are no longer supported. File I/O functionality is available as - - -- [File Access with Visual Basic](../../../visual-basic/developing-apps/programming/drives-directories-files/file-access.md) +- [File Access with Visual Basic](../../developing-apps/programming/drives-directories-files/file-access.md) diff --git a/docs/visual-basic/language-reference/error-messages/membername-cannot-expose-type-typename-outside-the-project.md b/docs/visual-basic/language-reference/error-messages/membername-cannot-expose-type-typename-outside-the-project.md index adc7f639064bc..b4013a3d39520 100644 --- a/docs/visual-basic/language-reference/error-messages/membername-cannot-expose-type-typename-outside-the-project.md +++ b/docs/visual-basic/language-reference/error-messages/membername-cannot-expose-type-typename-outside-the-project.md @@ -31,4 +31,4 @@ End Class ## See also -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) diff --git a/docs/visual-basic/language-reference/error-messages/membername-is-ambiguous-across-the-inherited-interfaces.md b/docs/visual-basic/language-reference/error-messages/membername-is-ambiguous-across-the-inherited-interfaces.md index 52748c78d4eb1..7c42c1939d8e2 100644 --- a/docs/visual-basic/language-reference/error-messages/membername-is-ambiguous-across-the-inherited-interfaces.md +++ b/docs/visual-basic/language-reference/error-messages/membername-is-ambiguous-across-the-inherited-interfaces.md @@ -42,4 +42,4 @@ The interface inherits two or more members with the same name from multiple inte ## See also -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/message-this-error-could-also-be-due-to-mixing-a-file-reference.md b/docs/visual-basic/language-reference/error-messages/message-this-error-could-also-be-due-to-mixing-a-file-reference.md index 2b3bc92346663..b64ec87923a5d 100644 --- a/docs/visual-basic/language-reference/error-messages/message-this-error-could-also-be-due-to-mixing-a-file-reference.md +++ b/docs/visual-basic/language-reference/error-messages/message-this-error-could-also-be-due-to-mixing-a-file-reference.md @@ -26,7 +26,7 @@ ms.assetid: 75d2e8b5-2fdc-4623-8b32-cba805dab7db ## See also - [Managing references in a project](/visualstudio/ide/managing-references-in-a-project) -- [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md) +- [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md) - [Managing Project and Solution Properties](/visualstudio/ide/managing-project-and-solution-properties) - [Troubleshooting Broken References](/visualstudio/ide/troubleshooting-broken-references) diff --git a/docs/visual-basic/language-reference/error-messages/method-does-not-have-a-signature-compatible-with-the-delegate.md b/docs/visual-basic/language-reference/error-messages/method-does-not-have-a-signature-compatible-with-the-delegate.md index a97f7ba4d805e..e111c9da8ea64 100644 --- a/docs/visual-basic/language-reference/error-messages/method-does-not-have-a-signature-compatible-with-the-delegate.md +++ b/docs/visual-basic/language-reference/error-messages/method-does-not-have-a-signature-compatible-with-the-delegate.md @@ -15,7 +15,7 @@ There is an incompatibility between the signatures of the method and the delegat ## See also -- [AddressOf Operator](../../../visual-basic/language-reference/operators/addressof-operator.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) -- [Overload Resolution](../../../visual-basic/programming-guide/language-features/procedures/overload-resolution.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) +- [AddressOf Operator](../operators/addressof-operator.md) +- [Delegate Statement](../statements/delegate-statement.md) +- [Overload Resolution](../../programming-guide/language-features/procedures/overload-resolution.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/methodname-has-multiple-definitions-with-identical-signatures.md b/docs/visual-basic/language-reference/error-messages/methodname-has-multiple-definitions-with-identical-signatures.md index 62b430ffd48fa..e73839338159c 100644 --- a/docs/visual-basic/language-reference/error-messages/methodname-has-multiple-definitions-with-identical-signatures.md +++ b/docs/visual-basic/language-reference/error-messages/methodname-has-multiple-definitions-with-identical-signatures.md @@ -19,5 +19,5 @@ A `Function` or `Sub` procedure declaration uses the identical procedure name an ## See also -- [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md) -- [Considerations in Overloading Procedures](../../../visual-basic/programming-guide/language-features/procedures/considerations-in-overloading-procedures.md) +- [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md) +- [Considerations in Overloading Procedures](../../programming-guide/language-features/procedures/considerations-in-overloading-procedures.md) diff --git a/docs/visual-basic/language-reference/error-messages/methods-of-system-nullable-of-t-cannot-be-used-as-operands-of-the-addressof.md b/docs/visual-basic/language-reference/error-messages/methods-of-system-nullable-of-t-cannot-be-used-as-operands-of-the-addressof.md index 0ff93182055da..cbbdab4d2a05e 100644 --- a/docs/visual-basic/language-reference/error-messages/methods-of-system-nullable-of-t-cannot-be-used-as-operands-of-the-addressof.md +++ b/docs/visual-basic/language-reference/error-messages/methods-of-system-nullable-of-t-cannot-be-used-as-operands-of-the-addressof.md @@ -58,6 +58,6 @@ End Module ## See also - -- [AddressOf Operator](../../../visual-basic/language-reference/operators/addressof-operator.md) -- [Nullable Value Types](../../../visual-basic/programming-guide/language-features/data-types/nullable-value-types.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) +- [AddressOf Operator](../operators/addressof-operator.md) +- [Nullable Value Types](../../programming-guide/language-features/data-types/nullable-value-types.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/module-statements-can-occur-only-at-file-or-namespace-level.md b/docs/visual-basic/language-reference/error-messages/module-statements-can-occur-only-at-file-or-namespace-level.md index 56406296eb3ec..fb4900381cea2 100644 --- a/docs/visual-basic/language-reference/error-messages/module-statements-can-occur-only-at-file-or-namespace-level.md +++ b/docs/visual-basic/language-reference/error-messages/module-statements-can-occur-only-at-file-or-namespace-level.md @@ -19,4 +19,4 @@ ms.assetid: 5e9de8e5-d26b-4fb2-9e28-814413fe9cef ## See also -- [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md) +- [Module Statement](../statements/module-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/name-is-ambiguous-in-the-namespace-namespacename.md b/docs/visual-basic/language-reference/error-messages/name-is-ambiguous-in-the-namespace-namespacename.md index b548354d25d10..188f4b5cd530d 100644 --- a/docs/visual-basic/language-reference/error-messages/name-is-ambiguous-in-the-namespace-namespacename.md +++ b/docs/visual-basic/language-reference/error-messages/name-is-ambiguous-in-the-namespace-namespacename.md @@ -19,5 +19,5 @@ You have provided a name that is ambiguous and therefore conflicts with another ## See also -- [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md) -- [Namespace Statement](../../../visual-basic/language-reference/statements/namespace-statement.md) +- [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md) +- [Namespace Statement](../statements/namespace-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/name-membername-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/name-membername-is-not-cls-compliant.md index f4310aa8818ac..6ae870198a1c8 100644 --- a/docs/visual-basic/language-reference/error-messages/name-membername-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/name-membername-is-not-cls-compliant.md @@ -11,7 +11,7 @@ ms.assetid: e2b885dc-cbf9-49ff-bbbe-531657ea99f7 # Name \ is not CLS-compliant An assembly is marked as `` but exposes a member with a name that begins with an underscore (`_`). - A programming element can contain one or more underscores, but to be compliant with the [Language Independence and Language-Independent Components](../../../standard/language-independence-and-language-independent-components.md) (CLS), it must not begin with an underscore. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). + A programming element can contain one or more underscores, but to be compliant with the [Language Independence and Language-Independent Components](../../../standard/language-independence-and-language-independent-components.md) (CLS), it must not begin with an underscore. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). When you apply the to a programming element, you set the attribute's `isCompliant` parameter to either `True` or `False` to indicate compliance or noncompliance. There is no default for this parameter, and you must supply a value. @@ -29,5 +29,5 @@ An assembly is marked as `` but exposes a member with a name ## See also -- [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md) -- [Visual Basic Naming Conventions](../../../visual-basic/programming-guide/program-structure/naming-conventions.md) +- [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md) +- [Visual Basic Naming Conventions](../../programming-guide/program-structure/naming-conventions.md) diff --git a/docs/visual-basic/language-reference/error-messages/name-name-is-not-declared.md b/docs/visual-basic/language-reference/error-messages/name-name-is-not-declared.md index c70c98ce745f7..7eb90e0f85d5b 100644 --- a/docs/visual-basic/language-reference/error-messages/name-name-is-not-declared.md +++ b/docs/visual-basic/language-reference/error-messages/name-name-is-not-declared.md @@ -37,7 +37,7 @@ A statement refers to a programming element, but the compiler cannot find an ele ## See also -- [Declarations and Constants Summary](../../../visual-basic/language-reference/keywords/declarations-and-constants-summary.md) -- [Visual Basic Naming Conventions](../../../visual-basic/programming-guide/program-structure/naming-conventions.md) -- [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md) -- [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md) +- [Declarations and Constants Summary](../keywords/declarations-and-constants-summary.md) +- [Visual Basic Naming Conventions](../../programming-guide/program-structure/naming-conventions.md) +- [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md) +- [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md) diff --git a/docs/visual-basic/language-reference/error-messages/name-namespacename-in-the-root-namespace-fullnamespacename-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/name-namespacename-in-the-root-namespace-fullnamespacename-is-not-cls-compliant.md index 19cfcc0978c98..8b6ecc844153c 100644 --- a/docs/visual-basic/language-reference/error-messages/name-namespacename-in-the-root-namespace-fullnamespacename-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/name-namespacename-in-the-root-namespace-fullnamespacename-is-not-cls-compliant.md @@ -11,7 +11,7 @@ ms.assetid: c5bd5914-ae71-416a-8bed-f76f644f78be # Name \ in the root namespace \ is not CLS-compliant An assembly is marked as ``, but an element of the root namespace name begins with an underscore (`_`). - A programming element can contain one or more underscores, but to be compliant with the [Language Independence and Language-Independent Components](../../../standard/language-independence-and-language-independent-components.md) (CLS), it must not begin with an underscore. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). + A programming element can contain one or more underscores, but to be compliant with the [Language Independence and Language-Independent Components](../../../standard/language-independence-and-language-independent-components.md) (CLS), it must not begin with an underscore. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). When you apply the to a programming element, you set the attribute's `isCompliant` parameter to either `True` or `False` to indicate compliance or noncompliance. There is no default for this parameter, and you must supply a value. @@ -29,9 +29,9 @@ An assembly is marked as ``, but an element of the root name ## See also -- [Namespace Statement](../../../visual-basic/language-reference/statements/namespace-statement.md) -- [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md) -- [-rootnamespace](../../../visual-basic/reference/command-line-compiler/rootnamespace.md) +- [Namespace Statement](../statements/namespace-statement.md) +- [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md) +- [-rootnamespace](../../reference/command-line-compiler/rootnamespace.md) - [Application Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/application-page-project-designer-visual-basic) -- [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md) -- [Visual Basic Naming Conventions](../../../visual-basic/programming-guide/program-structure/naming-conventions.md) +- [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md) +- [Visual Basic Naming Conventions](../../programming-guide/program-structure/naming-conventions.md) diff --git a/docs/visual-basic/language-reference/error-messages/name1-is-ambiguous-imported-from-the-namespaces-or-types-name2.md b/docs/visual-basic/language-reference/error-messages/name1-is-ambiguous-imported-from-the-namespaces-or-types-name2.md index a715be4b7447a..f59a7cdc51a34 100644 --- a/docs/visual-basic/language-reference/error-messages/name1-is-ambiguous-imported-from-the-namespaces-or-types-name2.md +++ b/docs/visual-basic/language-reference/error-messages/name1-is-ambiguous-imported-from-the-namespaces-or-types-name2.md @@ -21,6 +21,6 @@ You have provided a name that is ambiguous and therefore conflicts with another ## See also -- [Imports Statement (.NET Namespace and Type)](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md) -- [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md) -- [Namespace Statement](../../../visual-basic/language-reference/statements/namespace-statement.md) +- [Imports Statement (.NET Namespace and Type)](../statements/imports-statement-net-namespace-and-type.md) +- [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md) +- [Namespace Statement](../statements/namespace-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-imports-qualifiedelementname.md b/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-imports-qualifiedelementname.md index 2d2b807f256c9..cd8040e467f0f 100644 --- a/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-imports-qualifiedelementname.md +++ b/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-imports-qualifiedelementname.md @@ -17,7 +17,7 @@ An `Imports` statement specifies a containing element that either cannot be foun A *containing element* can be a namespace, class, structure, module, interface, or enumeration. The containing element contains members, such as variables, procedures, or other containing elements. -The purpose of importing is to allow your code to access namespace or type members without having to qualify them. Your project might also need to add a reference to the namespace or type. For more information, see "Importing Containing Elements" in [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md). +The purpose of importing is to allow your code to access namespace or type members without having to qualify them. Your project might also need to add a reference to the namespace or type. For more information, see "Importing Containing Elements" in [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md). If the compiler cannot find the specified containing element, then it cannot resolve references that use it. If it finds the element but the element does not expose any `Public` members, then no reference can be successful. In either case it is meaningless to import the element. @@ -43,8 +43,8 @@ Imports behave = winfrm.Design.Behavior` ## See also -- [Imports Statement (.NET Namespace and Type)](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md) -- [Namespace Statement](../../../visual-basic/language-reference/statements/namespace-statement.md) -- [Public](../../../visual-basic/language-reference/modifiers/public.md) -- [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md) -- [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md) +- [Imports Statement (.NET Namespace and Type)](../statements/imports-statement-net-namespace-and-type.md) +- [Namespace Statement](../statements/namespace-statement.md) +- [Public](../modifiers/public.md) +- [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md) +- [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md) diff --git a/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-project-level-imports-qualifiedelementname.md b/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-project-level-imports-qualifiedelementname.md index 42443e281f695..0500a4d646a65 100644 --- a/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-project-level-imports-qualifiedelementname.md +++ b/docs/visual-basic/language-reference/error-messages/namespace-or-type-specified-in-the-project-level-imports-qualifiedelementname.md @@ -15,7 +15,7 @@ Namespace or type specified in the project-level Imports '\ [!TIP] - > The `Option Strict` statement disallows implicit typing that results in an `Object` type. If you omit the type, a compile-time error will occur. See [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md). + > The `Option Strict` statement disallows implicit typing that results in an `Object` type. If you omit the type, a compile-time error will occur. See [Option Strict Statement](../statements/option-strict-statement.md). - You are attempting to reference an object that has been set to `Nothing`. @@ -46,6 +46,6 @@ An invalid object variable is being referenced. This error can occur for sever ## See also -- [Object Variable Declaration](../../../visual-basic/programming-guide/language-features/variables/object-variable-declaration.md) -- [ReDim Statement](../../../visual-basic/language-reference/statements/redim-statement.md) -- [With...End With Statement](../../../visual-basic/language-reference/statements/with-end-with-statement.md) +- [Object Variable Declaration](../../programming-guide/language-features/variables/object-variable-declaration.md) +- [ReDim Statement](../statements/redim-statement.md) +- [With...End With Statement](../statements/with-end-with-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/operator-declaration-must-be-one-of.md b/docs/visual-basic/language-reference/error-messages/operator-declaration-must-be-one-of.md index 82980f6acd6b9..5efddc4b05c66 100644 --- a/docs/visual-basic/language-reference/error-messages/operator-declaration-must-be-one-of.md +++ b/docs/visual-basic/language-reference/error-messages/operator-declaration-must-be-one-of.md @@ -29,8 +29,8 @@ You can declare only an operator that is eligible for overloading. The following ## See also -- [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) -- [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md) -- [How to: Define an Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-an-operator.md) -- [How to: Define a Conversion Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Operator Statement](../statements/operator-statement.md) +- [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md) +- [How to: Define an Operator](../../programming-guide/language-features/procedures/how-to-define-an-operator.md) +- [How to: Define a Conversion Operator](../../programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) +- [Function Statement](../statements/function-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/optional-expected.md b/docs/visual-basic/language-reference/error-messages/optional-expected.md index 77eeee11428c8..6a63b0f180f75 100644 --- a/docs/visual-basic/language-reference/error-messages/optional-expected.md +++ b/docs/visual-basic/language-reference/error-messages/optional-expected.md @@ -21,4 +21,4 @@ An optional argument in a procedure declaration is followed by a required argume ## See also -- [Optional Parameters](../../../visual-basic/programming-guide/language-features/procedures/optional-parameters.md) +- [Optional Parameters](../../programming-guide/language-features/procedures/optional-parameters.md) diff --git a/docs/visual-basic/language-reference/error-messages/ordinal-is-not-valid.md b/docs/visual-basic/language-reference/error-messages/ordinal-is-not-valid.md index cef9eeebe9e8c..cf997ca7bceef 100644 --- a/docs/visual-basic/language-reference/error-messages/ordinal-is-not-valid.md +++ b/docs/visual-basic/language-reference/error-messages/ordinal-is-not-valid.md @@ -24,4 +24,4 @@ Your call to a dynamic-link library (DLL) indicated to use a number instead of a ## See also -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Declare Statement](../statements/declare-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/out-of-memory-visual-basic-compiler-error.md b/docs/visual-basic/language-reference/error-messages/out-of-memory-visual-basic-compiler-error.md index 6f4178e7c917e..16ad91e6d1304 100644 --- a/docs/visual-basic/language-reference/error-messages/out-of-memory-visual-basic-compiler-error.md +++ b/docs/visual-basic/language-reference/error-messages/out-of-memory-visual-basic-compiler-error.md @@ -29,4 +29,4 @@ More memory was required than is available. ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/out-of-string-space.md b/docs/visual-basic/language-reference/error-messages/out-of-string-space.md index eee1f1b2e9171..3cfac57d6cb15 100644 --- a/docs/visual-basic/language-reference/error-messages/out-of-string-space.md +++ b/docs/visual-basic/language-reference/error-messages/out-of-string-space.md @@ -16,5 +16,5 @@ With Visual Basic, you can use very large strings. However, the requirements of ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) -- [String Manipulation Summary](../../../visual-basic/language-reference/keywords/string-manipulation-summary.md) +- [Error Types](../../programming-guide/language-features/error-types.md) +- [String Manipulation Summary](../keywords/string-manipulation-summary.md) diff --git a/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-error.md b/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-error.md index c74969e189553..a049bd7a8e3ac 100644 --- a/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-error.md +++ b/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-error.md @@ -19,4 +19,4 @@ A literal represents a value outside the limits of the data type to which it is ## See also -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) +- [Data Types](../data-types/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-run-time-error.md b/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-run-time-error.md index d2cab56fea2ab..35adc583deb7d 100644 --- a/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-run-time-error.md +++ b/docs/visual-basic/language-reference/error-messages/overflow-visual-basic-run-time-error.md @@ -20,5 +20,5 @@ An overflow results when you attempt an assignment that exceeds the limits of th - - -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Data Types](../data-types/index.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/path-file-access-error.md b/docs/visual-basic/language-reference/error-messages/path-file-access-error.md index a552f1b2d633c..d7543b6533090 100644 --- a/docs/visual-basic/language-reference/error-messages/path-file-access-error.md +++ b/docs/visual-basic/language-reference/error-messages/path-file-access-error.md @@ -20,4 +20,4 @@ During a file-access or disk-access operation, the operating system could not ma ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/path-not-found.md b/docs/visual-basic/language-reference/error-messages/path-not-found.md index 08753df1fba2e..243728b159cac 100644 --- a/docs/visual-basic/language-reference/error-messages/path-not-found.md +++ b/docs/visual-basic/language-reference/error-messages/path-not-found.md @@ -14,4 +14,4 @@ During a file-access or disk-access operation, the operating system was unable t ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/permission-denied.md b/docs/visual-basic/language-reference/error-messages/permission-denied.md index a0b5eb727d9bd..099e0fa46fb8e 100644 --- a/docs/visual-basic/language-reference/error-messages/permission-denied.md +++ b/docs/visual-basic/language-reference/error-messages/permission-denied.md @@ -18,4 +18,4 @@ An attempt was made to write to a write-protected disk or to access a locked fil ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/procedure-call-or-argument-is-not-valid.md b/docs/visual-basic/language-reference/error-messages/procedure-call-or-argument-is-not-valid.md index f73b190f7159e..da07217f60637 100644 --- a/docs/visual-basic/language-reference/error-messages/procedure-call-or-argument-is-not-valid.md +++ b/docs/visual-basic/language-reference/error-messages/procedure-call-or-argument-is-not-valid.md @@ -14,4 +14,4 @@ Some part of the call cannot be completed. ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/property-array-index-is-not-valid.md b/docs/visual-basic/language-reference/error-messages/property-array-index-is-not-valid.md index d815a10024b08..182b251a96e70 100644 --- a/docs/visual-basic/language-reference/error-messages/property-array-index-is-not-valid.md +++ b/docs/visual-basic/language-reference/error-messages/property-array-index-is-not-valid.md @@ -14,4 +14,4 @@ The supplied value is not valid for a property array index. ## See also -- [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md) +- [Arrays](../../programming-guide/language-features/arrays/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/property-not-found.md b/docs/visual-basic/language-reference/error-messages/property-not-found.md index f07fd11589354..90e30b81d5c24 100644 --- a/docs/visual-basic/language-reference/error-messages/property-not-found.md +++ b/docs/visual-basic/language-reference/error-messages/property-not-found.md @@ -16,4 +16,4 @@ This object does not support the specified property. ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/property-or-method-not-found.md b/docs/visual-basic/language-reference/error-messages/property-or-method-not-found.md index 21881997e8845..eab3c698f66b0 100644 --- a/docs/visual-basic/language-reference/error-messages/property-or-method-not-found.md +++ b/docs/visual-basic/language-reference/error-messages/property-or-method-not-found.md @@ -14,4 +14,4 @@ The referenced object method or object property is not defined. ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/property-propertyname-doesn-t-return-a-value-on-all-code-paths.md b/docs/visual-basic/language-reference/error-messages/property-propertyname-doesn-t-return-a-value-on-all-code-paths.md index af9805b83db31..4bebecc7e0435 100644 --- a/docs/visual-basic/language-reference/error-messages/property-propertyname-doesn-t-return-a-value-on-all-code-paths.md +++ b/docs/visual-basic/language-reference/error-messages/property-propertyname-doesn-t-return-a-value-on-all-code-paths.md @@ -19,9 +19,9 @@ Property '\' doesn't return a value on all code paths. A null refe - Assign the value to the property name and then perform the `End Get` statement. -- Include the value in a [Return Statement](../../../visual-basic/language-reference/statements/return-statement.md). +- Include the value in a [Return Statement](../statements/return-statement.md). - If control passes to `Exit Property` or `End Get` and you have not assigned any value to the property name, the `Get` procedure returns the default value of the property's data type. For more information, see "Behavior" in [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md). + If control passes to `Exit Property` or `End Get` and you have not assigned any value to the property name, the `Get` procedure returns the default value of the property's data type. For more information, see "Behavior" in [Function Statement](../statements/function-statement.md). By default, this message is a warning. For more information on hiding warnings or treating warnings as errors, see [Configuring Warnings in Visual Basic](/visualstudio/ide/configuring-warnings-in-visual-basic). @@ -35,6 +35,6 @@ Property '\' doesn't return a value on all code paths. A null refe ## See also -- [Property Procedures](../../../visual-basic/programming-guide/language-features/procedures/property-procedures.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Get Statement](../../../visual-basic/language-reference/statements/get-statement.md) +- [Property Procedures](../../programming-guide/language-features/procedures/property-procedures.md) +- [Property Statement](../statements/property-statement.md) +- [Get Statement](../statements/get-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/range-variable-name-can-be-inferred.md b/docs/visual-basic/language-reference/error-messages/range-variable-name-can-be-inferred.md index f27d02d422407..b6dd2460fd035 100644 --- a/docs/visual-basic/language-reference/error-messages/range-variable-name-can-be-inferred.md +++ b/docs/visual-basic/language-reference/error-messages/range-variable-name-can-be-inferred.md @@ -25,5 +25,5 @@ Dim query = From var1 In collection1 ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Select Clause](../queries/select-clause.md) diff --git a/docs/visual-basic/language-reference/error-messages/range-variable-variable-hides-a-variable-in-an-enclosing-block.md b/docs/visual-basic/language-reference/error-messages/range-variable-variable-hides-a-variable-in-an-enclosing-block.md index 6d3ac79a3709a..93e281ebd0c41 100644 --- a/docs/visual-basic/language-reference/error-messages/range-variable-variable-hides-a-variable-in-an-enclosing-block.md +++ b/docs/visual-basic/language-reference/error-messages/range-variable-variable-hides-a-variable-in-an-enclosing-block.md @@ -19,8 +19,8 @@ A range variable name specified in a `Select`, `From`, `Aggregate`, or `Let` cla ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Let Clause](../../../visual-basic/language-reference/queries/let-clause.md) -- [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [From Clause](../queries/from-clause.md) +- [Let Clause](../queries/let-clause.md) +- [Aggregate Clause](../queries/aggregate-clause.md) +- [Select Clause](../queries/select-clause.md) diff --git a/docs/visual-basic/language-reference/error-messages/reference-required-to-assembly-containing-type-but-suitable-reference-not-found.md b/docs/visual-basic/language-reference/error-messages/reference-required-to-assembly-containing-type-but-suitable-reference-not-found.md index e2ca979e619e8..84b8306d15d67 100644 --- a/docs/visual-basic/language-reference/error-messages/reference-required-to-assembly-containing-type-but-suitable-reference-not-found.md +++ b/docs/visual-basic/language-reference/error-messages/reference-required-to-assembly-containing-type-but-suitable-reference-not-found.md @@ -26,7 +26,7 @@ An expression uses a type, such as a class, structure, interface, enumeration, o ## See also - [Managing references in a project](/visualstudio/ide/managing-references-in-a-project) -- [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md) +- [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md) - [Managing Project and Solution Properties](/visualstudio/ide/managing-project-and-solution-properties) - [Troubleshooting Broken References](/visualstudio/ide/troubleshooting-broken-references) diff --git a/docs/visual-basic/language-reference/error-messages/region-and-end-region-are-not-valid-within-method-bodies-multiline-lambdas.md b/docs/visual-basic/language-reference/error-messages/region-and-end-region-are-not-valid-within-method-bodies-multiline-lambdas.md index 916625a187bd0..67644562c5701 100644 --- a/docs/visual-basic/language-reference/error-messages/region-and-end-region-are-not-valid-within-method-bodies-multiline-lambdas.md +++ b/docs/visual-basic/language-reference/error-messages/region-and-end-region-are-not-valid-within-method-bodies-multiline-lambdas.md @@ -21,4 +21,4 @@ The `#Region` block must be declared at a class, module, or namespace level. A c ## See also -- [#Region Directive](../../../visual-basic/language-reference/directives/region-directive.md) +- [#Region Directive](../directives/region-directive.md) diff --git a/docs/visual-basic/language-reference/error-messages/resume-without-error.md b/docs/visual-basic/language-reference/error-messages/resume-without-error.md index 699f1a1ba0f88..f4779d43d8b6f 100644 --- a/docs/visual-basic/language-reference/error-messages/resume-without-error.md +++ b/docs/visual-basic/language-reference/error-messages/resume-without-error.md @@ -16,5 +16,5 @@ A `Resume` statement appeared outside error-handling code, or the code jumped in ## See also -- [Resume Statement](../../../visual-basic/language-reference/statements/resume-statement.md) -- [On Error Statement](../../../visual-basic/language-reference/statements/on-error-statement.md) +- [Resume Statement](../statements/resume-statement.md) +- [On Error Statement](../statements/on-error-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/return-type-of-function-procedurename-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/return-type-of-function-procedurename-is-not-cls-compliant.md index 9cec06eecbf93..3c8628adef0d2 100644 --- a/docs/visual-basic/language-reference/error-messages/return-type-of-function-procedurename-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/return-type-of-function-procedurename-is-not-cls-compliant.md @@ -15,13 +15,13 @@ A `Function` procedure is marked as `` but returns a type th The following Visual Basic data types are not CLS-compliant: -- [SByte Data Type](../../../visual-basic/language-reference/data-types/sbyte-data-type.md) +- [SByte Data Type](../data-types/sbyte-data-type.md) -- [UInteger Data Type](../../../visual-basic/language-reference/data-types/uinteger-data-type.md) +- [UInteger Data Type](../data-types/uinteger-data-type.md) -- [ULong Data Type](../../../visual-basic/language-reference/data-types/ulong-data-type.md) +- [ULong Data Type](../data-types/ulong-data-type.md) -- [UShort Data Type](../../../visual-basic/language-reference/data-types/ushort-data-type.md) +- [UShort Data Type](../data-types/ushort-data-type.md) When you apply the to a programming element, you set the attribute's `isCompliant` parameter to either `True` or `False` to indicate compliance or noncompliance. There is no default for this parameter, and you must supply a value. diff --git a/docs/visual-basic/language-reference/error-messages/set-accessor-of-property-propertyname-is-not-accessible.md b/docs/visual-basic/language-reference/error-messages/set-accessor-of-property-propertyname-is-not-accessible.md index eb845700f674b..f0513aa99213c 100644 --- a/docs/visual-basic/language-reference/error-messages/set-accessor-of-property-propertyname-is-not-accessible.md +++ b/docs/visual-basic/language-reference/error-messages/set-accessor-of-property-propertyname-is-not-accessible.md @@ -11,13 +11,13 @@ ms.assetid: 6f7b31b7-3656-4ae1-8851-90f5f4c6950a # 'Set' accessor of property '\' is not accessible A statement attempts to store the value of a property when it does not have access to the property's `Set` procedure. - If the [Set Statement](../../../visual-basic/language-reference/statements/set-statement.md) is marked with a more restrictive access level than its [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md), an attempt to set the property value could fail in the following cases: + If the [Set Statement](../statements/set-statement.md) is marked with a more restrictive access level than its [Property Statement](../statements/property-statement.md), an attempt to set the property value could fail in the following cases: -- The `Set` statement is marked [Private](../../../visual-basic/language-reference/modifiers/private.md) and the calling code is outside the class or structure in which the property is defined. +- The `Set` statement is marked [Private](../modifiers/private.md) and the calling code is outside the class or structure in which the property is defined. -- The `Set` statement is marked [Protected](../../../visual-basic/language-reference/modifiers/protected.md) and the calling code is not in the class or structure in which the property is defined, nor in a derived class. +- The `Set` statement is marked [Protected](../modifiers/protected.md) and the calling code is not in the class or structure in which the property is defined, nor in a derived class. -- The `Set` statement is marked [Friend](../../../visual-basic/language-reference/modifiers/friend.md) and the calling code is not in the same assembly in which the property is defined. +- The `Set` statement is marked [Friend](../modifiers/friend.md) and the calling code is not in the same assembly in which the property is defined. **Error ID:** BC31102 @@ -29,5 +29,5 @@ A statement attempts to store the value of a property when it does not have acce ## See also -- [Property Procedures](../../../visual-basic/programming-guide/language-features/procedures/property-procedures.md) -- [How to: Declare a Property with Mixed Access Levels](../../../visual-basic/programming-guide/language-features/procedures/how-to-declare-a-property-with-mixed-access-levels.md) +- [Property Procedures](../../programming-guide/language-features/procedures/property-procedures.md) +- [How to: Declare a Property with Mixed Access Levels](../../programming-guide/language-features/procedures/how-to-declare-a-property-with-mixed-access-levels.md) diff --git a/docs/visual-basic/language-reference/error-messages/statement-cannot-end-a-block-outside-of-a-line-if-statement.md b/docs/visual-basic/language-reference/error-messages/statement-cannot-end-a-block-outside-of-a-line-if-statement.md index 7f3c0fd781052..5292a75603730 100644 --- a/docs/visual-basic/language-reference/error-messages/statement-cannot-end-a-block-outside-of-a-line-if-statement.md +++ b/docs/visual-basic/language-reference/error-messages/statement-cannot-end-a-block-outside-of-a-line-if-statement.md @@ -19,4 +19,4 @@ A single-line `If` statement contains several statements separated by colons (:) ## See also -- [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) +- [If...Then...Else Statement](../statements/if-then-else-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-in-a-namespace.md b/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-in-a-namespace.md index 4f2ce5ead4fda..363b5d66bc39b 100644 --- a/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-in-a-namespace.md +++ b/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-in-a-namespace.md @@ -19,5 +19,5 @@ The statement cannot appear at the level of a namespace. The only declarations a ## See also -- [Scope in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/scope.md) -- [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md) +- [Scope in Visual Basic](../../programming-guide/language-features/declared-elements/scope.md) +- [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md) diff --git a/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-inside-a-method-multiline-lambda.md b/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-inside-a-method-multiline-lambda.md index 5a561b5a316cc..149d3b32e6e19 100644 --- a/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-inside-a-method-multiline-lambda.md +++ b/docs/visual-basic/language-reference/error-messages/statement-is-not-valid-inside-a-method-multiline-lambda.md @@ -19,7 +19,7 @@ The statement is not valid within a `Sub`, `Function`, property `Get`, or proper ## See also -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Get Statement](../../../visual-basic/language-reference/statements/get-statement.md) -- [Set Statement](../../../visual-basic/language-reference/statements/set-statement.md) +- [Sub Statement](../statements/sub-statement.md) +- [Function Statement](../statements/function-statement.md) +- [Get Statement](../statements/get-statement.md) +- [Set Statement](../statements/set-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/string-constants-must-end-with-a-double-quote.md b/docs/visual-basic/language-reference/error-messages/string-constants-must-end-with-a-double-quote.md index 05aaaaadae504..319f0318649ae 100644 --- a/docs/visual-basic/language-reference/error-messages/string-constants-must-end-with-a-double-quote.md +++ b/docs/visual-basic/language-reference/error-messages/string-constants-must-end-with-a-double-quote.md @@ -19,4 +19,4 @@ String constants must begin and end with quotation marks. ## See also -- [Strings](../../../visual-basic/programming-guide/language-features/strings/index.md) +- [Strings](../../programming-guide/language-features/strings/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/structure-structurename-must-contain.md b/docs/visual-basic/language-reference/error-messages/structure-structurename-must-contain.md index 72472db05c32d..47e273f4c864b 100644 --- a/docs/visual-basic/language-reference/error-messages/structure-structurename-must-contain.md +++ b/docs/visual-basic/language-reference/error-messages/structure-structurename-must-contain.md @@ -11,7 +11,7 @@ ms.assetid: 7054cc1e-bac3-4c3d-82f3-35772bd8dd3b # Structure '\' must contain at least one instance member variable or at least one instance event declaration not marked 'Custom' A structure definition does not include any nonshared variables or nonshared noncustom events. - Every structure must have either a variable or an event that applies to each specific instance (nonshared) instead of to all instances collectively ([Shared](../../../visual-basic/language-reference/modifiers/shared.md)). Nonshared constants, properties, and procedures do not satisfy this requirement. In addition, if there are no nonshared variables and only one nonshared event, that event cannot be a `Custom` event. + Every structure must have either a variable or an event that applies to each specific instance (nonshared) instead of to all instances collectively ([Shared](../modifiers/shared.md)). Nonshared constants, properties, and procedures do not satisfy this requirement. In addition, if there are no nonshared variables and only one nonshared event, that event cannot be a `Custom` event. **Error ID:** BC30941 @@ -21,6 +21,6 @@ A structure definition does not include any nonshared variables or nonshared non ## See also -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [How to: Declare a Structure](../../../visual-basic/programming-guide/language-features/data-types/how-to-declare-a-structure.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [How to: Declare a Structure](../../programming-guide/language-features/data-types/how-to-declare-a-structure.md) +- [Structure Statement](../statements/structure-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/sub-main-was-not-found-in-name.md b/docs/visual-basic/language-reference/error-messages/sub-main-was-not-found-in-name.md index 763727608a214..0966ac2f5c9b3 100644 --- a/docs/visual-basic/language-reference/error-messages/sub-main-was-not-found-in-name.md +++ b/docs/visual-basic/language-reference/error-messages/sub-main-was-not-found-in-name.md @@ -16,11 +16,11 @@ ms.assetid: a006d57d-4dd3-46a7-9026-ca9a31470da7 ## To correct this error -1. Supply the missing `Sub Main` statement, or if it exists, move it to the appropriate location in the code. For more information on `Sub Main`, see [Main Procedure in Visual Basic](../../../visual-basic/programming-guide/program-structure/main-procedure.md). +1. Supply the missing `Sub Main` statement, or if it exists, move it to the appropriate location in the code. For more information on `Sub Main`, see [Main Procedure in Visual Basic](../../programming-guide/program-structure/main-procedure.md). 2. Specify the location of the project's startup object in the **Startup form** box of the **Project Designer**. ## See also -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Main Procedure in Visual Basic](../../../visual-basic/programming-guide/program-structure/main-procedure.md) +- [Sub Statement](../statements/sub-statement.md) +- [Main Procedure in Visual Basic](../../programming-guide/program-structure/main-procedure.md) diff --git a/docs/visual-basic/language-reference/error-messages/sub-or-function-not-defined.md b/docs/visual-basic/language-reference/error-messages/sub-or-function-not-defined.md index a26a2ff3867fb..eb451e04ffa34 100644 --- a/docs/visual-basic/language-reference/error-messages/sub-or-function-not-defined.md +++ b/docs/visual-basic/language-reference/error-messages/sub-or-function-not-defined.md @@ -26,7 +26,7 @@ A `Sub` or `Function` must be defined in order to be called. Possible causes of ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) - [Managing references in a project](/visualstudio/ide/managing-references-in-a-project) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Sub Statement](../statements/sub-statement.md) +- [Function Statement](../statements/function-statement.md) diff --git a/docs/visual-basic/language-reference/error-messages/subscript-out-of-range.md b/docs/visual-basic/language-reference/error-messages/subscript-out-of-range.md index d14b299135c36..c5f72a7c0938c 100644 --- a/docs/visual-basic/language-reference/error-messages/subscript-out-of-range.md +++ b/docs/visual-basic/language-reference/error-messages/subscript-out-of-range.md @@ -15,4 +15,4 @@ An array subscript is not valid because it falls outside the allowable range. Th ## See also - -- [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md) +- [Arrays](../../programming-guide/language-features/arrays/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/textfieldparser-is-unable-to-complete-read-operation.md b/docs/visual-basic/language-reference/error-messages/textfieldparser-is-unable-to-complete-read-operation.md index d395576e53d97..27dc6844ba1db 100644 --- a/docs/visual-basic/language-reference/error-messages/textfieldparser-is-unable-to-complete-read-operation.md +++ b/docs/visual-basic/language-reference/error-messages/textfieldparser-is-unable-to-complete-read-operation.md @@ -16,5 +16,5 @@ The operation cannot be completed because the maximum buffer size (10,000,000 by - - -- [How to: Read From Text Files with Multiple Formats](../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md) -- [Parsing Text Files with the TextFieldParser Object](../../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) +- [How to: Read From Text Files with Multiple Formats](../../developing-apps/programming/drives-directories-files/how-to-read-from-text-files-with-multiple-formats.md) +- [Parsing Text Files with the TextFieldParser Object](../../developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) diff --git a/docs/visual-basic/language-reference/error-messages/the-type-for-variable-variablename-will-not-be-inferred.md b/docs/visual-basic/language-reference/error-messages/the-type-for-variable-variablename-will-not-be-inferred.md index efcf82de2b14b..3fc6449e34342 100644 --- a/docs/visual-basic/language-reference/error-messages/the-type-for-variable-variablename-will-not-be-inferred.md +++ b/docs/visual-basic/language-reference/error-messages/the-type-for-variable-variablename-will-not-be-inferred.md @@ -78,9 +78,9 @@ End Class ## See also -- [Option Infer Statement](../../../visual-basic/language-reference/statements/option-infer-statement.md) -- [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md) -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [How to: Refer to the Current Instance of an Object](../../../visual-basic/programming-guide/language-features/variables/how-to-refer-to-the-current-instance-of-an-object.md) -- [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md) -- [Me, My, MyBase, and MyClass](../../../visual-basic/programming-guide/program-structure/me-my-mybase-and-myclass.md) +- [Option Infer Statement](../statements/option-infer-statement.md) +- [For Each...Next Statement](../statements/for-each-next-statement.md) +- [For...Next Statement](../statements/for-next-statement.md) +- [How to: Refer to the Current Instance of an Object](../../programming-guide/language-features/variables/how-to-refer-to-the-current-instance-of-an-object.md) +- [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md) +- [Me, My, MyBase, and MyClass](../../programming-guide/program-structure/me-my-mybase-and-myclass.md) diff --git a/docs/visual-basic/language-reference/error-messages/this-array-is-fixed-or-temporarily-locked.md b/docs/visual-basic/language-reference/error-messages/this-array-is-fixed-or-temporarily-locked.md index d6c432082dcaf..ef5d38429c0cc 100644 --- a/docs/visual-basic/language-reference/error-messages/this-array-is-fixed-or-temporarily-locked.md +++ b/docs/visual-basic/language-reference/error-messages/this-array-is-fixed-or-temporarily-locked.md @@ -24,4 +24,4 @@ This error has the following possible causes: ## See also -- [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md) +- [Arrays](../../programming-guide/language-features/arrays/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/this-key-is-already-associated-with-an-element-of-this-collection.md b/docs/visual-basic/language-reference/error-messages/this-key-is-already-associated-with-an-element-of-this-collection.md index 83d3de4339168..ce267274293cd 100644 --- a/docs/visual-basic/language-reference/error-messages/this-key-is-already-associated-with-an-element-of-this-collection.md +++ b/docs/visual-basic/language-reference/error-messages/this-key-is-already-associated-with-an-element-of-this-collection.md @@ -14,4 +14,4 @@ The specified a key for a collection member already identifies another member of ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/too-many-files.md b/docs/visual-basic/language-reference/error-messages/too-many-files.md index e0297241a6e28..640d2c763717c 100644 --- a/docs/visual-basic/language-reference/error-messages/too-many-files.md +++ b/docs/visual-basic/language-reference/error-messages/too-many-files.md @@ -16,4 +16,4 @@ Either more files have been created in the root directory than the operating sys ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/type-arguments-could-not-be-inferred-from-the-delegate.md b/docs/visual-basic/language-reference/error-messages/type-arguments-could-not-be-inferred-from-the-delegate.md index ab58d5479bb16..1ad967b149702 100644 --- a/docs/visual-basic/language-reference/error-messages/type-arguments-could-not-be-inferred-from-the-delegate.md +++ b/docs/visual-basic/language-reference/error-messages/type-arguments-could-not-be-inferred-from-the-delegate.md @@ -21,8 +21,8 @@ An assignment statement uses `AddressOf` to assign the address of a generic proc ## See also -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [AddressOf Operator](../../../visual-basic/language-reference/operators/addressof-operator.md) -- [Generic Procedures in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-procedures.md) -- [Type List](../../../visual-basic/language-reference/statements/type-list.md) -- [Extension Methods](../../../visual-basic/programming-guide/language-features/procedures/extension-methods.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [AddressOf Operator](../operators/addressof-operator.md) +- [Generic Procedures in Visual Basic](../../programming-guide/language-features/data-types/generic-procedures.md) +- [Type List](../statements/type-list.md) +- [Extension Methods](../../programming-guide/language-features/procedures/extension-methods.md) diff --git a/docs/visual-basic/language-reference/error-messages/type-mismatch.md b/docs/visual-basic/language-reference/error-messages/type-mismatch.md index 9b529c39b05ab..536e3c22cda9d 100644 --- a/docs/visual-basic/language-reference/error-messages/type-mismatch.md +++ b/docs/visual-basic/language-reference/error-messages/type-mismatch.md @@ -18,4 +18,4 @@ You attempted to convert a value to another type in a way that is not valid. ## See also -- [Error Types](../../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/language-reference/error-messages/type-of-member-membername-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/type-of-member-membername-is-not-cls-compliant.md index beb0b9585ba94..108ed10aacfc6 100644 --- a/docs/visual-basic/language-reference/error-messages/type-of-member-membername-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/type-of-member-membername-is-not-cls-compliant.md @@ -13,13 +13,13 @@ The data type specified for this member is not part of the [Language Independenc The following Visual Basic data types are not CLS-compliant: -- [SByte Data Type](../../../visual-basic/language-reference/data-types/sbyte-data-type.md) +- [SByte Data Type](../data-types/sbyte-data-type.md) -- [UInteger Data Type](../../../visual-basic/language-reference/data-types/uinteger-data-type.md) +- [UInteger Data Type](../data-types/uinteger-data-type.md) -- [ULong Data Type](../../../visual-basic/language-reference/data-types/ulong-data-type.md) +- [ULong Data Type](../data-types/ulong-data-type.md) -- [UShort Data Type](../../../visual-basic/language-reference/data-types/ushort-data-type.md) +- [UShort Data Type](../data-types/ushort-data-type.md) By default, this message is a warning. For more information on hiding warnings or treating warnings as errors, see [Configuring Warnings in Visual Basic](/visualstudio/ide/configuring-warnings-in-visual-basic). diff --git a/docs/visual-basic/language-reference/error-messages/type-of-optional-value-for-optional-parameter-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/type-of-optional-value-for-optional-parameter-is-not-cls-compliant.md index a2479658df791..9396afd969715 100644 --- a/docs/visual-basic/language-reference/error-messages/type-of-optional-value-for-optional-parameter-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/type-of-optional-value-for-optional-parameter-is-not-cls-compliant.md @@ -9,19 +9,19 @@ helpviewer_keywords: ms.assetid: 1d6eae29-4ad3-4434-bde4-a53b6051adf5 --- # Type of optional value for optional parameter \ is not CLS-compliant -A procedure is marked as `` but declares an [Optional](../../../visual-basic/language-reference/modifiers/optional.md) parameter with default value of a noncompliant type. +A procedure is marked as `` but declares an [Optional](../modifiers/optional.md) parameter with default value of a noncompliant type. For a procedure to be compliant with the [Language Independence and Language-Independent Components](../../../standard/language-independence-and-language-independent-components.md) (CLS), it must use only CLS-compliant types. This applies to the types of the parameters, the return type, and the types of all its local variables. It also applies to the default values of optional parameters. The following Visual Basic data types are not CLS-compliant: -- [SByte Data Type](../../../visual-basic/language-reference/data-types/sbyte-data-type.md) +- [SByte Data Type](../data-types/sbyte-data-type.md) -- [UInteger Data Type](../../../visual-basic/language-reference/data-types/uinteger-data-type.md) +- [UInteger Data Type](../data-types/uinteger-data-type.md) -- [ULong Data Type](../../../visual-basic/language-reference/data-types/ulong-data-type.md) +- [ULong Data Type](../data-types/ulong-data-type.md) -- [UShort Data Type](../../../visual-basic/language-reference/data-types/ushort-data-type.md) +- [UShort Data Type](../data-types/ushort-data-type.md) When you apply the attribute to a programming element, you set the attribute's `isCompliant` parameter to either `True` or `False` to indicate compliance or noncompliance. There is no default for this parameter, and you must supply a value. diff --git a/docs/visual-basic/language-reference/error-messages/type-of-parameter-parametername-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/type-of-parameter-parametername-is-not-cls-compliant.md index 21edbfe13f49d..ef025bcd99d1e 100644 --- a/docs/visual-basic/language-reference/error-messages/type-of-parameter-parametername-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/type-of-parameter-parametername-is-not-cls-compliant.md @@ -15,13 +15,13 @@ A procedure is marked as `` but declares a parameter with a The following Visual Basic data types are not CLS-compliant: -- [SByte Data Type](../../../visual-basic/language-reference/data-types/sbyte-data-type.md) +- [SByte Data Type](../data-types/sbyte-data-type.md) -- [UInteger Data Type](../../../visual-basic/language-reference/data-types/uinteger-data-type.md) +- [UInteger Data Type](../data-types/uinteger-data-type.md) -- [ULong Data Type](../../../visual-basic/language-reference/data-types/ulong-data-type.md) +- [ULong Data Type](../data-types/ulong-data-type.md) -- [UShort Data Type](../../../visual-basic/language-reference/data-types/ushort-data-type.md) +- [UShort Data Type](../data-types/ushort-data-type.md) When you apply the to a programming element, you set the attribute's `isCompliant` parameter to either `True` or `False` to indicate compliance or noncompliance. There is no default for this parameter, and you must supply a value. diff --git a/docs/visual-basic/language-reference/error-messages/type-of-variablename-cannot-be-inferred.md b/docs/visual-basic/language-reference/error-messages/type-of-variablename-cannot-be-inferred.md index 14f79b4e48aa5..64ade1fdaae90 100644 --- a/docs/visual-basic/language-reference/error-messages/type-of-variablename-cannot-be-inferred.md +++ b/docs/visual-basic/language-reference/error-messages/type-of-variablename-cannot-be-inferred.md @@ -60,9 +60,9 @@ Dim n = 20 ## See also - -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) -- [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md) -- [Option Infer Statement](../../../visual-basic/language-reference/statements/option-infer-statement.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [For...Next Statement](../statements/for-next-statement.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md) +- [Option Infer Statement](../statements/option-infer-statement.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) diff --git a/docs/visual-basic/language-reference/error-messages/type-typename-has-no-constructors.md b/docs/visual-basic/language-reference/error-messages/type-typename-has-no-constructors.md index b5faeae9e527f..ba4e1f0549932 100644 --- a/docs/visual-basic/language-reference/error-messages/type-typename-has-no-constructors.md +++ b/docs/visual-basic/language-reference/error-messages/type-typename-has-no-constructors.md @@ -25,5 +25,5 @@ A type does not support a call to `Sub New()`. One possible cause is a corrupted ## See also -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) - [Talk to Us](/visualstudio/ide/feedback-options) diff --git a/docs/visual-basic/language-reference/error-messages/type-typename-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/type-typename-is-not-cls-compliant.md index 9905484824eb2..66f10e7778fda 100644 --- a/docs/visual-basic/language-reference/error-messages/type-typename-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/type-typename-is-not-cls-compliant.md @@ -15,13 +15,13 @@ A variable, property, or function return is declared with a data type that is no The following Visual Basic data types are not CLS-compliant: -- [SByte Data Type](../../../visual-basic/language-reference/data-types/sbyte-data-type.md) +- [SByte Data Type](../data-types/sbyte-data-type.md) -- [UInteger Data Type](../../../visual-basic/language-reference/data-types/uinteger-data-type.md) +- [UInteger Data Type](../data-types/uinteger-data-type.md) -- [ULong Data Type](../../../visual-basic/language-reference/data-types/ulong-data-type.md) +- [ULong Data Type](../data-types/ulong-data-type.md) -- [UShort Data Type](../../../visual-basic/language-reference/data-types/ushort-data-type.md) +- [UShort Data Type](../data-types/ushort-data-type.md) **Error ID:** BC40041 diff --git a/docs/visual-basic/language-reference/error-messages/type-typename-is-not-defined.md b/docs/visual-basic/language-reference/error-messages/type-typename-is-not-defined.md index 32bd2ca7f73d1..e62960ab65c1f 100644 --- a/docs/visual-basic/language-reference/error-messages/type-typename-is-not-defined.md +++ b/docs/visual-basic/language-reference/error-messages/type-typename-is-not-defined.md @@ -27,9 +27,9 @@ The statement has made reference to a type that has not been defined. You can de ## See also -- [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md) -- [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) +- [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md) +- [Enum Statement](../statements/enum-statement.md) +- [Structure Statement](../statements/structure-statement.md) +- [Class Statement](../statements/class-statement.md) +- [Interface Statement](../statements/interface-statement.md) - [Managing references in a project](/visualstudio/ide/managing-references-in-a-project) diff --git a/docs/visual-basic/language-reference/error-messages/type1-must-implement-membername-for-interface.md b/docs/visual-basic/language-reference/error-messages/type1-must-implement-membername-for-interface.md index a1c9201abb07d..9092b9d93ba3a 100644 --- a/docs/visual-basic/language-reference/error-messages/type1-must-implement-membername-for-interface.md +++ b/docs/visual-basic/language-reference/error-messages/type1-must-implement-membername-for-interface.md @@ -31,5 +31,5 @@ ms.assetid: 259afdfa-3608-4760-adcb-88ec0da5020d ## See also -- [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md) -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) +- [Implements Statement](../statements/implements-statement.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/type1-typename-must-implement-methodname-for-interface-interfacename.md b/docs/visual-basic/language-reference/error-messages/type1-typename-must-implement-methodname-for-interface-interfacename.md index c77ccac9ecb1c..a62dfb781a821 100644 --- a/docs/visual-basic/language-reference/error-messages/type1-typename-must-implement-methodname-for-interface-interfacename.md +++ b/docs/visual-basic/language-reference/error-messages/type1-typename-must-implement-methodname-for-interface-interfacename.md @@ -25,5 +25,5 @@ A class or structure claims to implement an interface but does not implement a p ## See also -- [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md) -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) +- [Implements Statement](../statements/implements-statement.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/typename-cannot-inherit-from-type-basetypename.md b/docs/visual-basic/language-reference/error-messages/typename-cannot-inherit-from-type-basetypename.md index 494d4c404c119..d03baaea1ce56 100644 --- a/docs/visual-basic/language-reference/error-messages/typename-cannot-inherit-from-type-basetypename.md +++ b/docs/visual-basic/language-reference/error-messages/typename-cannot-inherit-from-type-basetypename.md @@ -25,7 +25,7 @@ A class or interface inherits from a base class or interface but has a less rest ## See also -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) -- [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) +- [Class Statement](../statements/class-statement.md) +- [Interface Statement](../statements/interface-statement.md) +- [Inherits Statement](../statements/inherits-statement.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) diff --git a/docs/visual-basic/language-reference/error-messages/typename-is-a-delegate-type.md b/docs/visual-basic/language-reference/error-messages/typename-is-a-delegate-type.md index 54b0694e4978a..97b0c8bdef24d 100644 --- a/docs/visual-basic/language-reference/error-messages/typename-is-a-delegate-type.md +++ b/docs/visual-basic/language-reference/error-messages/typename-is-a-delegate-type.md @@ -25,7 +25,7 @@ ms.assetid: dc6abba0-a9ad-450f-8899-87265bc84abc ## See also -- [New Operator](../../../visual-basic/language-reference/operators/new-operator.md) -- [AddressOf Operator](../../../visual-basic/language-reference/operators/addressof-operator.md) -- [Delegates](../../../visual-basic/programming-guide/language-features/delegates/index.md) -- [How to: Invoke a Delegate Method](../../../visual-basic/programming-guide/language-features/delegates/how-to-invoke-a-delegate-method.md) +- [New Operator](../operators/new-operator.md) +- [AddressOf Operator](../operators/addressof-operator.md) +- [Delegates](../../programming-guide/language-features/delegates/index.md) +- [How to: Invoke a Delegate Method](../../programming-guide/language-features/delegates/how-to-invoke-a-delegate-method.md) diff --git a/docs/visual-basic/language-reference/error-messages/typename-is-a-type-and-cannot-be-used-as-an-expression.md b/docs/visual-basic/language-reference/error-messages/typename-is-a-type-and-cannot-be-used-as-an-expression.md index 581e305e081b8..2d56c9b8e7bfe 100644 --- a/docs/visual-basic/language-reference/error-messages/typename-is-a-type-and-cannot-be-used-as-an-expression.md +++ b/docs/visual-basic/language-reference/error-messages/typename-is-a-type-and-cannot-be-used-as-an-expression.md @@ -19,4 +19,4 @@ A type name occurs where an expression is required. An expression must consist o ## See also -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/underlying-type-typename-of-enum-is-not-cls-compliant.md b/docs/visual-basic/language-reference/error-messages/underlying-type-typename-of-enum-is-not-cls-compliant.md index 4a448b7f3312b..fb17bbf117766 100644 --- a/docs/visual-basic/language-reference/error-messages/underlying-type-typename-of-enum-is-not-cls-compliant.md +++ b/docs/visual-basic/language-reference/error-messages/underlying-type-typename-of-enum-is-not-cls-compliant.md @@ -13,13 +13,13 @@ The data type specified for this enumeration is not part of the [Language Indepe The following Visual Basic data types are not CLS-compliant: -- [SByte Data Type](../../../visual-basic/language-reference/data-types/sbyte-data-type.md) +- [SByte Data Type](../data-types/sbyte-data-type.md) -- [UInteger Data Type](../../../visual-basic/language-reference/data-types/uinteger-data-type.md) +- [UInteger Data Type](../data-types/uinteger-data-type.md) -- [ULong Data Type](../../../visual-basic/language-reference/data-types/ulong-data-type.md) +- [ULong Data Type](../data-types/ulong-data-type.md) -- [UShort Data Type](../../../visual-basic/language-reference/data-types/ushort-data-type.md) +- [UShort Data Type](../data-types/ushort-data-type.md) By default, this message is a warning. For more information on hiding warnings or treating warnings as errors, see [Configuring Warnings in Visual Basic](/visualstudio/ide/configuring-warnings-in-visual-basic). diff --git a/docs/visual-basic/language-reference/error-messages/using-the-iteration-variable-in-a-lambda-expression-may-have-unexpected-results.md b/docs/visual-basic/language-reference/error-messages/using-the-iteration-variable-in-a-lambda-expression-may-have-unexpected-results.md index 466e17d916057..88341bdc46bc9 100644 --- a/docs/visual-basic/language-reference/error-messages/using-the-iteration-variable-in-a-lambda-expression-may-have-unexpected-results.md +++ b/docs/visual-basic/language-reference/error-messages/using-the-iteration-variable-in-a-lambda-expression-may-have-unexpected-results.md @@ -79,4 +79,4 @@ End Module ## See also -- [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md) +- [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md) diff --git a/docs/visual-basic/language-reference/error-messages/value-of-type-type1-cannot-be-converted-to-type2.md b/docs/visual-basic/language-reference/error-messages/value-of-type-type1-cannot-be-converted-to-type2.md index 73e9122002f26..880c862a09b48 100644 --- a/docs/visual-basic/language-reference/error-messages/value-of-type-type1-cannot-be-converted-to-type2.md +++ b/docs/visual-basic/language-reference/error-messages/value-of-type-type1-cannot-be-converted-to-type2.md @@ -22,6 +22,6 @@ Value of type 'type1' cannot be converted to 'type2'. You can use the 'Value' pr ## See also - -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [XML Literals](../xml-literals/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2-multiple.md b/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2-multiple.md index 49cb3e4ac67c1..c70b6efa4e0fd 100644 --- a/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2-multiple.md +++ b/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2-multiple.md @@ -27,5 +27,5 @@ Value of type '\' cannot be converted to '\'. Type mismatc ## See also -- [Type Conversions in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/type-conversions.md) +- [Type Conversions in Visual Basic](../../programming-guide/language-features/data-types/type-conversions.md) - [Managing references in a project](/visualstudio/ide/managing-references-in-a-project) diff --git a/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2.md b/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2.md index 774602f6c5695..0c557dd26e371 100644 --- a/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2.md +++ b/docs/visual-basic/language-reference/error-messages/value-of-type-typename1-cannot-be-converted-to-typename2.md @@ -55,5 +55,5 @@ Value of type '\' cannot be converted to '\'. Type mismatc ## See also -- [Type Conversions in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/type-conversions.md) +- [Type Conversions in Visual Basic](../../programming-guide/language-features/data-types/type-conversions.md) - [Managing references in a project](/visualstudio/ide/managing-references-in-a-project) diff --git a/docs/visual-basic/language-reference/error-messages/variable-uses-an-automation-type-not-supported.md b/docs/visual-basic/language-reference/error-messages/variable-uses-an-automation-type-not-supported.md index 01dca92af5054..f0566d885900a 100644 --- a/docs/visual-basic/language-reference/error-messages/variable-uses-an-automation-type-not-supported.md +++ b/docs/visual-basic/language-reference/error-messages/variable-uses-an-automation-type-not-supported.md @@ -20,4 +20,4 @@ You tried to use a variable defined in a type library or object library that has ## See also -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) +- [Data Types](../data-types/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/variable-variablename-hides-a-variable-in-an-enclosing-block.md b/docs/visual-basic/language-reference/error-messages/variable-variablename-hides-a-variable-in-an-enclosing-block.md index 32a62bf5dd451..c612c70847dba 100644 --- a/docs/visual-basic/language-reference/error-messages/variable-variablename-hides-a-variable-in-an-enclosing-block.md +++ b/docs/visual-basic/language-reference/error-messages/variable-variablename-hides-a-variable-in-an-enclosing-block.md @@ -30,5 +30,5 @@ A variable enclosed in a block has the same name as another local variable. ## See also -- [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) -- [Variable Declaration](../../../visual-basic/programming-guide/language-features/variables/variable-declaration.md) +- [Try...Catch...Finally Statement](../statements/try-catch-finally-statement.md) +- [Variable Declaration](../../programming-guide/language-features/variables/variable-declaration.md) diff --git a/docs/visual-basic/language-reference/error-messages/variable-variablename-is-used-before-it-has-been-assigned-a-value.md b/docs/visual-basic/language-reference/error-messages/variable-variablename-is-used-before-it-has-been-assigned-a-value.md index c4c5deba27fcd..c3e868ab0c200 100644 --- a/docs/visual-basic/language-reference/error-messages/variable-variablename-is-used-before-it-has-been-assigned-a-value.md +++ b/docs/visual-basic/language-reference/error-messages/variable-variablename-is-used-before-it-has-been-assigned-a-value.md @@ -13,7 +13,7 @@ Variable '\' is used before it has been assigned a value. A null r An application has at least one possible path through its code that reads a variable before any value is assigned to it. - If a variable has never been assigned a value, it holds the default value for its data type. For a reference data type, that default value is [Nothing](../../../visual-basic/language-reference/nothing.md). Reading a reference variable that has a value of `Nothing` can cause a in some circumstances. + If a variable has never been assigned a value, it holds the default value for its data type. For a reference data type, that default value is [Nothing](../nothing.md). Reading a reference variable that has a value of `Nothing` can cause a in some circumstances. By default, this message is a warning. For more information on hiding warnings or treating warnings as errors, see [Configuring Warnings in Visual Basic](/visualstudio/ide/configuring-warnings-in-visual-basic). @@ -23,10 +23,10 @@ Variable '\' is used before it has been assigned a value. A null r - Check your control flow logic and make sure the variable has a valid value before control passes to any statement that reads it. -- One way to guarantee that the variable always has a valid value is to initialize it as part of its declaration. See "Initialization" in [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md). +- One way to guarantee that the variable always has a valid value is to initialize it as part of its declaration. See "Initialization" in [Dim Statement](../statements/dim-statement.md). ## See also -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) -- [Variable Declaration](../../../visual-basic/programming-guide/language-features/variables/variable-declaration.md) -- [Troubleshooting Variables](../../../visual-basic/programming-guide/language-features/variables/troubleshooting-variables.md) +- [Dim Statement](../statements/dim-statement.md) +- [Variable Declaration](../../programming-guide/language-features/variables/variable-declaration.md) +- [Troubleshooting Variables](../../programming-guide/language-features/variables/troubleshooting-variables.md) diff --git a/docs/visual-basic/language-reference/error-messages/xml-axis-properties-do-not-support-late-binding.md b/docs/visual-basic/language-reference/error-messages/xml-axis-properties-do-not-support-late-binding.md index 738d68303a032..e9bd71696b3ac 100644 --- a/docs/visual-basic/language-reference/error-messages/xml-axis-properties-do-not-support-late-binding.md +++ b/docs/visual-basic/language-reference/error-messages/xml-axis-properties-do-not-support-late-binding.md @@ -19,5 +19,5 @@ An XML axis property has been referenced for an untyped object. ## See also -- [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md) -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [XML Axis Properties](../xml-axis/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/xml-comment-exception-must-have-a-cref-attribute.md b/docs/visual-basic/language-reference/error-messages/xml-comment-exception-must-have-a-cref-attribute.md index ffe71be81ca85..dd9539dcf2fd6 100644 --- a/docs/visual-basic/language-reference/error-messages/xml-comment-exception-must-have-a-cref-attribute.md +++ b/docs/visual-basic/language-reference/error-messages/xml-comment-exception-must-have-a-cref-attribute.md @@ -24,6 +24,6 @@ Add the `cref` attribute to the exception as follows: ## See also -- [\](../../../visual-basic/language-reference/xmldoc/exception.md) -- [How to: Create XML Documentation](../../../visual-basic/programming-guide/program-structure/how-to-create-xml-documentation.md) -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [\](../xmldoc/exception.md) +- [How to: Create XML Documentation](../../programming-guide/program-structure/how-to-create-xml-documentation.md) +- [XML Comment Tags](../xmldoc/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/xml-entity-references-are-not-supported.md b/docs/visual-basic/language-reference/error-messages/xml-entity-references-are-not-supported.md index 76cdba2be9edf..69d3691f3130e 100644 --- a/docs/visual-basic/language-reference/error-messages/xml-entity-references-are-not-supported.md +++ b/docs/visual-basic/language-reference/error-messages/xml-entity-references-are-not-supported.md @@ -19,6 +19,6 @@ An entity reference (for example, `©`) that is not defined in the XML 1.0 speci ## See also -- [XML Literals and the XML 1.0 Specification](../../../visual-basic/programming-guide/language-features/xml/xml-literals-and-the-xml-1-0-specification.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [XML Literals and the XML 1.0 Specification](../../programming-guide/language-features/xml/xml-literals-and-the-xml-1-0-specification.md) +- [XML Literals](../xml-literals/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/xml-literals-and-xml-properties-are-not-supported-in-embedded-code-in-aspnet.md b/docs/visual-basic/language-reference/error-messages/xml-literals-and-xml-properties-are-not-supported-in-embedded-code-in-aspnet.md index acd94bc12224b..2ebdada21990d 100644 --- a/docs/visual-basic/language-reference/error-messages/xml-literals-and-xml-properties-are-not-supported-in-embedded-code-in-aspnet.md +++ b/docs/visual-basic/language-reference/error-messages/xml-literals-and-xml-properties-are-not-supported-in-embedded-code-in-aspnet.md @@ -21,6 +21,6 @@ XML literals and XML properties are not supported in embedded code within ASP.NE ## See also -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md) -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [XML Literals](../xml-literals/index.md) +- [XML Axis Properties](../xml-axis/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/error-messages/xml-namespace-uri-uri-can-be-bound-only-to-xmlns.md b/docs/visual-basic/language-reference/error-messages/xml-namespace-uri-uri-can-be-bound-only-to-xmlns.md index 78049b61167ad..5b93e94146828 100644 --- a/docs/visual-basic/language-reference/error-messages/xml-namespace-uri-uri-can-be-bound-only-to-xmlns.md +++ b/docs/visual-basic/language-reference/error-messages/xml-namespace-uri-uri-can-be-bound-only-to-xmlns.md @@ -19,6 +19,6 @@ Remove the XML namespace declaration or replace the URI `http://www.w3.org/XML/1 ## See also -- [Imports Statement (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [Imports Statement (XML Namespace)](../statements/imports-statement-xml-namespace.md) +- [XML Literals](../xml-literals/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/functions/conversion-functions.md b/docs/visual-basic/language-reference/functions/conversion-functions.md index 7c1abd2561f6c..dcf97548a6fea 100644 --- a/docs/visual-basic/language-reference/functions/conversion-functions.md +++ b/docs/visual-basic/language-reference/functions/conversion-functions.md @@ -18,25 +18,25 @@ ms.assetid: 8a8fb553-a8ac-424e-8103-26eea25eaa71 - - -- [CBool Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CByte Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CChar Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CDate Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CDbl Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CDec Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) +- [CBool Function](type-conversion-functions.md) +- [CByte Function](type-conversion-functions.md) +- [CChar Function](type-conversion-functions.md) +- [CDate Function](type-conversion-functions.md) +- [CDbl Function](type-conversion-functions.md) +- [CDec Function](type-conversion-functions.md) - - -- [CInt Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CLng Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CObj Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CSByte Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CShort Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CSng Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CStr Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) -- [CUInt Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CULng Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [CUShort Function](../../../visual-basic/language-reference/functions/type-conversion-functions.md) +- [CInt Function](type-conversion-functions.md) +- [CLng Function](type-conversion-functions.md) +- [CObj Function](type-conversion-functions.md) +- [CSByte Function](type-conversion-functions.md) +- [CShort Function](type-conversion-functions.md) +- [CSng Function](type-conversion-functions.md) +- [CStr Function](type-conversion-functions.md) +- [CType Function](ctype-function.md) +- [CUInt Function](type-conversion-functions.md) +- [CULng Function](type-conversion-functions.md) +- [CUShort Function](type-conversion-functions.md) - - - @@ -45,5 +45,5 @@ ms.assetid: 8a8fb553-a8ac-424e-8103-26eea25eaa71 ## See also -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Converting Data Types](../../../visual-basic/programming-guide/concepts/linq/converting-data-types.md) +- [Type Conversion Functions](type-conversion-functions.md) +- [Converting Data Types](../../programming-guide/concepts/linq/converting-data-types.md) diff --git a/docs/visual-basic/language-reference/functions/ctype-function.md b/docs/visual-basic/language-reference/functions/ctype-function.md index 6dfaf35bcf6ae..54090613ecb40 100644 --- a/docs/visual-basic/language-reference/functions/ctype-function.md +++ b/docs/visual-basic/language-reference/functions/ctype-function.md @@ -34,8 +34,8 @@ Any expression that is legal within an `As` clause in a `Dim` statement, that is > [!TIP] > You can also use the following functions to perform a type conversion: > -> - Type conversion functions such as `CByte`, `CDbl`, and `CInt` that perform a conversion to a specific data type. For more information, see [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md). -> - [DirectCast Operator](../../../visual-basic/language-reference/operators/directcast-operator.md) or [TryCast Operator](../../../visual-basic/language-reference/operators/trycast-operator.md). These operators require that one type inherit from or implement the other type. They can provide somewhat better performance than `CType` when converting to and from the `Object` data type. +> - Type conversion functions such as `CByte`, `CDbl`, and `CInt` that perform a conversion to a specific data type. For more information, see [Type Conversion Functions](type-conversion-functions.md). +> - [DirectCast Operator](../operators/directcast-operator.md) or [TryCast Operator](../operators/trycast-operator.md). These operators require that one type inherit from or implement the other type. They can provide somewhat better performance than `CType` when converting to and from the `Object` data type. `CType` is compiled inline, which means that the conversion code is part of the code that evaluates the expression. In some cases, the code runs faster because no procedures are called to perform the conversion. @@ -47,7 +47,7 @@ If the data type of `expression` or `typename` is a class or structure you've de ## Overloading -The `CType` operator can also be overloaded on a class or structure defined outside your code. If your code converts to or from such a class or structure, be sure you understand the behavior of its `CType` operator. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +The `CType` operator can also be overloaded on a class or structure defined outside your code. If your code converts to or from such a class or structure, be sure you understand the behavior of its `CType` operator. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Converting Dynamic Objects @@ -59,14 +59,14 @@ The following example uses the `CType` function to convert an expression to the [!code-vb[VbVbalrFunctions#24](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrFunctions/VB/Class1.vb#24)] -For additional examples, see [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md). +For additional examples, see [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md). ## See also - - -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Conversion Functions](../../../visual-basic/language-reference/functions/conversion-functions.md) -- [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) -- [How to: Define a Conversion Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) +- [Type Conversion Functions](type-conversion-functions.md) +- [Conversion Functions](conversion-functions.md) +- [Operator Statement](../statements/operator-statement.md) +- [How to: Define a Conversion Operator](../../programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) - [Type Conversion in the .NET Framework](../../../standard/base-types/type-conversion.md) diff --git a/docs/visual-basic/language-reference/functions/index.md b/docs/visual-basic/language-reference/functions/index.md index db5d6f3f52c89..70ce47bf53c51 100644 --- a/docs/visual-basic/language-reference/functions/index.md +++ b/docs/visual-basic/language-reference/functions/index.md @@ -10,18 +10,18 @@ ms.assetid: d86fc51f-f46e-4941-8ae2-6262da3d2688 The topics in this section contain tables of the Visual Basic run-time member functions. > [!NOTE] -> You can also create functions and call them. For more information, see [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) and [How to: Create a Procedure that Returns a Value](../../../visual-basic/programming-guide/language-features/procedures/how-to-create-a-procedure-that-returns-a-value.md). +> You can also create functions and call them. For more information, see [Function Statement](../statements/function-statement.md) and [How to: Create a Procedure that Returns a Value](../../programming-guide/language-features/procedures/how-to-create-a-procedure-that-returns-a-value.md). ## In This Section - [Conversion Functions](../../../visual-basic/language-reference/functions/conversion-functions.md) + [Conversion Functions](conversion-functions.md) - [Math Functions](../../../visual-basic/language-reference/functions/math-functions.md) + [Math Functions](math-functions.md) - [String Functions](../../../visual-basic/language-reference/functions/string-functions.md) + [String Functions](string-functions.md) - [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) + [Type Conversion Functions](type-conversion-functions.md) - [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) + [CType Function](ctype-function.md) ## Related Sections - [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) + [Visual Basic Language Reference](../index.md) diff --git a/docs/visual-basic/language-reference/functions/return-values-for-the-cstr-function.md b/docs/visual-basic/language-reference/functions/return-values-for-the-cstr-function.md index 9daf012343c6b..fdb0f8da35601 100644 --- a/docs/visual-basic/language-reference/functions/return-values-for-the-cstr-function.md +++ b/docs/visual-basic/language-reference/functions/return-values-for-the-cstr-function.md @@ -17,9 +17,9 @@ The following table describes the return values for `CStr` for different data ty |If `expression` type is|`CStr` returns| |-----------------------------|--------------------| -|[Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md)|A string containing "True" or "False".| -|[Date Data Type](../../../visual-basic/language-reference/data-types/date-data-type.md)|A string containing a `Date` value (date and time) in the short date format of your system.| -|[Numeric Data Types](../../../visual-basic/programming-guide/language-features/data-types/numeric-data-types.md)|A string representing the number.| +|[Boolean Data Type](../data-types/boolean-data-type.md)|A string containing "True" or "False".| +|[Date Data Type](../data-types/date-data-type.md)|A string containing a `Date` value (date and time) in the short date format of your system.| +|[Numeric Data Types](../../programming-guide/language-features/data-types/numeric-data-types.md)|A string representing the number.| ## CStr and Date The `Date` type always contains both date and time information. For purposes of type conversion, Visual Basic considers 1/1/0001 (January 1 of the year 1) to be a *neutral value* for the date, and 00:00:00 (midnight) to be a neutral value for the time. `CStr` does not include neutral values in the resulting string. For example, if you convert `#January 1, 0001 9:30:00#` to a string, the result is "9:30:00 AM"; the date information is suppressed. However, the date information is still present in the original `Date` value and can be recovered with functions such as . @@ -30,6 +30,6 @@ The following table describes the return values for `CStr` for different data ty ## See also - -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md) -- [Date Data Type](../../../visual-basic/language-reference/data-types/date-data-type.md) +- [Type Conversion Functions](type-conversion-functions.md) +- [Boolean Data Type](../data-types/boolean-data-type.md) +- [Date Data Type](../data-types/date-data-type.md) diff --git a/docs/visual-basic/language-reference/functions/string-functions.md b/docs/visual-basic/language-reference/functions/string-functions.md index cc440cd766bd3..2aa9fcc6b06b1 100644 --- a/docs/visual-basic/language-reference/functions/string-functions.md +++ b/docs/visual-basic/language-reference/functions/string-functions.md @@ -41,7 +41,7 @@ The following table lists the functions that Visual Basic provides in the |Returns a string containing a copy of a specified string with no leading or trailing spaces.| ||Returns a string or character containing the specified string converted to uppercase.| -You can use the [Option Compare](../../../visual-basic/language-reference/statements/option-compare-statement.md) statement to set whether strings are compared using a case-insensitive text sort order determined by your system's locale (`Text`) or by the internal binary representations of the characters (`Binary`). The default text comparison method is `Binary`. +You can use the [Option Compare](../statements/option-compare-statement.md) statement to set whether strings are compared using a case-insensitive text sort order determined by your system's locale (`Text`) or by the internal binary representations of the characters (`Binary`). The default text comparison method is `Binary`. ## Example: UCase @@ -83,7 +83,7 @@ This example shows various uses of the `Format` function to format values using ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) -- [String Manipulation Summary](../../../visual-basic/language-reference/keywords/string-manipulation-summary.md) +- [Keywords](../keywords/index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) +- [String Manipulation Summary](../keywords/string-manipulation-summary.md) - [System.String class methods](xref:System.String#methods) diff --git a/docs/visual-basic/language-reference/functions/type-conversion-functions.md b/docs/visual-basic/language-reference/functions/type-conversion-functions.md index bbc85b9b0159a..7af307612bddf 100644 --- a/docs/visual-basic/language-reference/functions/type-conversion-functions.md +++ b/docs/visual-basic/language-reference/functions/type-conversion-functions.md @@ -118,28 +118,28 @@ The function name determines the data type of the value it returns, as shown in |Function name|Return data type|Range for `expression` argument| |-------------------|----------------------|-------------------------------------| -|`CBool`|[Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md)|Any valid `Char` or `String` or numeric expression.| -|`CByte`|[Byte Data Type](../../../visual-basic/language-reference/data-types/byte-data-type.md)| (0) through (255) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to byte conversion with the `CByte` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| -|`CChar`|[Char Data Type](../../../visual-basic/language-reference/data-types/char-data-type.md)|Any valid `Char` or `String` expression; only first character of a `String` is converted; value can be 0 through 65535 (unsigned).| -|`CDate`|[Date Data Type](../../../visual-basic/language-reference/data-types/date-data-type.md)|Any valid representation of a date and time.| -|`CDbl`|[Double Data Type](../../../visual-basic/language-reference/data-types/double-data-type.md)|-1.79769313486231570E+308 through -4.94065645841246544E-324 for negative values; 4.94065645841246544E-324 through 1.79769313486231570E+308 for positive values.| -|`CDec`|[Decimal Data Type](../../../visual-basic/language-reference/data-types/decimal-data-type.md)|+/-79,228,162,514,264,337,593,543,950,335 for zero-scaled numbers, that is, numbers with no decimal places. For numbers with 28 decimal places, the range is +/-7.9228162514264337593543950335. The smallest possible non-zero number is 0.0000000000000000000000000001 (+/-1E-28).| -|`CInt`|[Integer Data Type](../../../visual-basic/language-reference/data-types/integer-data-type.md)| (-2,147,483,648) through (2,147,483,647); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to integer conversion with the `CInt` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example. | -|`CLng`|[Long Data Type](../../../visual-basic/language-reference/data-types/long-data-type.md)| (-9,223,372,036,854,775,808) through (9,223,372,036,854,775,807); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to 64-bit integer conversion with the `CLng` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| -|`CObj`|[Object Data Type](../../../visual-basic/language-reference/data-types/object-data-type.md)|Any valid expression.| -|`CSByte`|[SByte Data Type](../../../visual-basic/language-reference/data-types/sbyte-data-type.md)| (-128) through (127); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to signed byte conversion with the `CSByte` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| -|`CShort`|[Short Data Type](../../../visual-basic/language-reference/data-types/short-data-type.md)| (-32,768) through (32,767); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to 16-bit integer conversion with the `CShort` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| -|`CSng`|[Single Data Type](../../../visual-basic/language-reference/data-types/single-data-type.md)|-3.402823E+38 through -1.401298E-45 for negative values; 1.401298E-45 through 3.402823E+38 for positive values.| -|`CStr`|[String Data Type](../../../visual-basic/language-reference/data-types/string-data-type.md)|Returns for `CStr` depend on the `expression` argument. See [Return Values for the CStr Function](../../../visual-basic/language-reference/functions/return-values-for-the-cstr-function.md).| -|`CUInt`|[UInteger Data Type](../../../visual-basic/language-reference/data-types/uinteger-data-type.md)| (0) through (4,294,967,295) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to unsigned integer conversion with the `CUInt` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| -|`CULng`|[ULong Data Type](../../../visual-basic/language-reference/data-types/ulong-data-type.md)| (0) through (18,446,744,073,709,551,615) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to unsigned long integer conversion with the `CULng` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| -|`CUShort`|[UShort Data Type](../../../visual-basic/language-reference/data-types/ushort-data-type.md)| (0) through (65,535) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to unsigned 16-bit integer conversion with the `CUShort` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| +|`CBool`|[Boolean Data Type](../data-types/boolean-data-type.md)|Any valid `Char` or `String` or numeric expression.| +|`CByte`|[Byte Data Type](../data-types/byte-data-type.md)| (0) through (255) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to byte conversion with the `CByte` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| +|`CChar`|[Char Data Type](../data-types/char-data-type.md)|Any valid `Char` or `String` expression; only first character of a `String` is converted; value can be 0 through 65535 (unsigned).| +|`CDate`|[Date Data Type](../data-types/date-data-type.md)|Any valid representation of a date and time.| +|`CDbl`|[Double Data Type](../data-types/double-data-type.md)|-1.79769313486231570E+308 through -4.94065645841246544E-324 for negative values; 4.94065645841246544E-324 through 1.79769313486231570E+308 for positive values.| +|`CDec`|[Decimal Data Type](../data-types/decimal-data-type.md)|+/-79,228,162,514,264,337,593,543,950,335 for zero-scaled numbers, that is, numbers with no decimal places. For numbers with 28 decimal places, the range is +/-7.9228162514264337593543950335. The smallest possible non-zero number is 0.0000000000000000000000000001 (+/-1E-28).| +|`CInt`|[Integer Data Type](../data-types/integer-data-type.md)| (-2,147,483,648) through (2,147,483,647); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to integer conversion with the `CInt` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example. | +|`CLng`|[Long Data Type](../data-types/long-data-type.md)| (-9,223,372,036,854,775,808) through (9,223,372,036,854,775,807); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to 64-bit integer conversion with the `CLng` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| +|`CObj`|[Object Data Type](../data-types/object-data-type.md)|Any valid expression.| +|`CSByte`|[SByte Data Type](../data-types/sbyte-data-type.md)| (-128) through (127); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to signed byte conversion with the `CSByte` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| +|`CShort`|[Short Data Type](../data-types/short-data-type.md)| (-32,768) through (32,767); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to 16-bit integer conversion with the `CShort` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| +|`CSng`|[Single Data Type](../data-types/single-data-type.md)|-3.402823E+38 through -1.401298E-45 for negative values; 1.401298E-45 through 3.402823E+38 for positive values.| +|`CStr`|[String Data Type](../data-types/string-data-type.md)|Returns for `CStr` depend on the `expression` argument. See [Return Values for the CStr Function](return-values-for-the-cstr-function.md).| +|`CUInt`|[UInteger Data Type](../data-types/uinteger-data-type.md)| (0) through (4,294,967,295) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to unsigned integer conversion with the `CUInt` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| +|`CULng`|[ULong Data Type](../data-types/ulong-data-type.md)| (0) through (18,446,744,073,709,551,615) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to unsigned long integer conversion with the `CULng` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| +|`CUShort`|[UShort Data Type](../data-types/ushort-data-type.md)| (0) through (65,535) (unsigned); fractional parts are rounded.1

Starting with Visual Basic 15.8, Visual Basic optimizes the performance of floating-point to unsigned 16-bit integer conversion with the `CUShort` function; see the [Remarks](#remarks) section for more information. See the [CInt Example](#cint-example) section for an example.| 1 Fractional parts can be subject to a special type of rounding called *banker's rounding*. See "Remarks" for more information. ## Remarks -As a rule, you should use the Visual Basic type conversion functions in preference to the .NET Framework methods such as `ToString()`, either on the class or on an individual type structure or class. The Visual Basic functions are designed for optimal interaction with Visual Basic code, and they also make your source code shorter and easier to read. In addition, the .NET Framework conversion methods do not always produce the same results as the Visual Basic functions, for example when converting `Boolean` to `Integer`. For more information, see [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md). +As a rule, you should use the Visual Basic type conversion functions in preference to the .NET Framework methods such as `ToString()`, either on the class or on an individual type structure or class. The Visual Basic functions are designed for optimal interaction with Visual Basic code, and they also make your source code shorter and easier to read. In addition, the .NET Framework conversion methods do not always produce the same results as the Visual Basic functions, for example when converting `Boolean` to `Integer`. For more information, see [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md). Starting with Visual Basic 15.8, the performance of floating-point-to-integer conversion is optimized when you pass the or value returned by the following methods to one of the integer conversion functions (`CByte`, `CShort`, `CInt`, `CLng`, `CSByte`, `CUShort`, `CUInt`, `CULng`): @@ -181,7 +181,7 @@ Dim i3 As Integer = CInt(Math.Round(s)) ' Result: 174 - **Date/Time Conversions.** Use the function to determine if a value can be converted to a date and time. `CDate` recognizes date literals and time literals but not numeric values. To convert a Visual Basic 6.0 `Date` value to a `Date` value in Visual Basic 2005 or later versions, you can use the method. -- **Neutral Date/Time Values.** The [Date Data Type](../../../visual-basic/language-reference/data-types/date-data-type.md) always contains both date and time information. For purposes of type conversion, Visual Basic considers 1/1/0001 (January 1 of the year 1) to be a *neutral value* for the date, and 00:00:00 (midnight) to be a neutral value for the time. If you convert a `Date` value to a string, `CStr` does not include neutral values in the resulting string. For example, if you convert `#January 1, 0001 9:30:00#` to a string, the result is "9:30:00 AM"; the date information is suppressed. However, the date information is still present in the original `Date` value and can be recovered with functions such as function. +- **Neutral Date/Time Values.** The [Date Data Type](../data-types/date-data-type.md) always contains both date and time information. For purposes of type conversion, Visual Basic considers 1/1/0001 (January 1 of the year 1) to be a *neutral value* for the date, and 00:00:00 (midnight) to be a neutral value for the time. If you convert a `Date` value to a string, `CStr` does not include neutral values in the resulting string. For example, if you convert `#January 1, 0001 9:30:00#` to a string, the result is "9:30:00 AM"; the date information is suppressed. However, the date information is still present in the original `Date` value and can be recovered with functions such as function. - **Culture Sensitivity.** The type conversion functions involving strings perform conversions based on the current culture settings for the application. For example, `CDate` recognizes date formats according to the locale setting of your system. You must provide the day, month, and year in the correct order for your locale, or the date might not be interpreted correctly. A long date format is not recognized if it contains a day-of-the-week string, such as "Wednesday". @@ -189,9 +189,9 @@ Dim i3 As Integer = CInt(Math.Round(s)) ' Result: 174 ## CType Function -The [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) takes a second argument, `typename`, and coerces `expression` to `typename`, where `typename` can be any data type, structure, class, or interface to which there exists a valid conversion. +The [CType Function](ctype-function.md) takes a second argument, `typename`, and coerces `expression` to `typename`, where `typename` can be any data type, structure, class, or interface to which there exists a valid conversion. -For a comparison of `CType` with the other type conversion keywords, see [DirectCast Operator](../../../visual-basic/language-reference/operators/directcast-operator.md) and [TryCast Operator](../../../visual-basic/language-reference/operators/trycast-operator.md). +For a comparison of `CType` with the other type conversion keywords, see [DirectCast Operator](../operators/directcast-operator.md) and [TryCast Operator](../operators/trycast-operator.md). ## CBool Example @@ -279,7 +279,7 @@ The following example uses the `CStr` function to convert `Date` values to `Stri `CStr` always renders a `Date` value in the standard short format for the current locale, for example, "6/15/2003 4:35:47 PM". However, `CStr` suppresses the *neutral values* of 1/1/0001 for the date and 00:00:00 for the time. -For more detail on the values returned by `CStr`, see [Return Values for the CStr Function](../../../visual-basic/language-reference/functions/return-values-for-the-cstr-function.md). +For more detail on the values returned by `CStr`, see [Return Values for the CStr Function](return-values-for-the-cstr-function.md). ## CUInt Example @@ -312,5 +312,5 @@ The following example uses the `CUShort` function to convert a numeric value to - - - -- [Conversion Functions](../../../visual-basic/language-reference/functions/conversion-functions.md) -- [Type Conversions in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/type-conversions.md) +- [Conversion Functions](conversion-functions.md) +- [Type Conversions in Visual Basic](../../programming-guide/language-features/data-types/type-conversions.md) diff --git a/docs/visual-basic/language-reference/index.md b/docs/visual-basic/language-reference/index.md index b3991d5bfdf11..7905778f4e34a 100644 --- a/docs/visual-basic/language-reference/index.md +++ b/docs/visual-basic/language-reference/index.md @@ -17,67 +17,67 @@ This section provides reference information for various aspects of the Visual Ba ## In This Section - [Typographic and Code Conventions](../../visual-basic/language-reference/typographic-and-code-conventions.md) + [Typographic and Code Conventions](typographic-and-code-conventions.md) Summarizes the way that keywords, placeholders, and other elements of the language are formatted in the Visual Basic documentation. - [Visual Basic Runtime Library Members](../../visual-basic/language-reference/runtime-library-members.md) + [Visual Basic Runtime Library Members](runtime-library-members.md) Lists the classes and modules of the namespace, with links to their member functions, methods, properties, constants, and enumerations. - [Keywords](../../visual-basic/language-reference/keywords/index.md) + [Keywords](keywords/index.md) Lists all Visual Basic keywords and provides links to more information. - [Attributes (Visual Basic)](../../visual-basic/language-reference/attributes.md) + [Attributes (Visual Basic)](attributes.md) Documents the attributes available in Visual Basic. - [Constants and Enumerations](../../visual-basic/language-reference/constants-and-enumerations.md) + [Constants and Enumerations](constants-and-enumerations.md) Documents the constants and enumerations available in Visual Basic. - [Data Types](../../visual-basic/language-reference/data-types/index.md) + [Data Types](data-types/index.md) Documents the data types available in Visual Basic. - [Directives](../../visual-basic/language-reference/directives/index.md) + [Directives](directives/index.md) Documents the compiler directives available in Visual Basic. - [Functions](../../visual-basic/language-reference/functions/index.md) + [Functions](functions/index.md) Documents the run-time functions available in Visual Basic. - [Modifiers](../../visual-basic/language-reference/modifiers/index.md) + [Modifiers](modifiers/index.md) Lists the Visual Basic run-time modifiers and provides links to more information. - [Modules](../../visual-basic/language-reference/modules.md) + [Modules](modules.md) Documents the modules available in Visual Basic and their members. - [Nothing](../../visual-basic/language-reference/nothing.md) + [Nothing](nothing.md) Describes the default value of any data type. - [Objects](../../visual-basic/language-reference/objects/index.md) + [Objects](objects/index.md) Documents the objects available in Visual Basic and their members. - [Operators](../../visual-basic/language-reference/operators/index.md) + [Operators](operators/index.md) Documents the operators available in Visual Basic. - [Properties](../../visual-basic/language-reference/properties.md) + [Properties](properties.md) Documents the properties available in Visual Basic. - [Queries](../../visual-basic/language-reference/queries/index.md) + [Queries](queries/index.md) Provides reference information about using Language-Integrated Query (LINQ) expressions in your code. - [Statements](../../visual-basic/language-reference/statements/index.md) + [Statements](statements/index.md) Documents the declaration and executable statements available in Visual Basic. - [XML Comment Tags](../../visual-basic/language-reference/xmldoc/index.md) + [XML Comment Tags](xmldoc/index.md) Describes the documentation comments for which IntelliSense is provided in the Visual Basic Code Editor. - [XML Axis Properties](../../visual-basic/language-reference/xml-axis/index.md) + [XML Axis Properties](xml-axis/index.md) Provides links to information about using XML axis properties to access XML directly in your code. - [XML Literals](../../visual-basic/language-reference/xml-literals/index.md) + [XML Literals](xml-literals/index.md) Provides links to information about using XML literals to incorporate XML directly in your code. - [Error Messages](../../visual-basic/language-reference/error-messages/index.md) + [Error Messages](error-messages/index.md) Provides a listing of Visual Basic compiler and run-time error messages and help on how to handle them. ## Related Sections - [Visual Basic Command-Line Compiler](../../visual-basic/reference/command-line-compiler/index.md) + [Visual Basic Command-Line Compiler](../reference/command-line-compiler/index.md) Describes how to use the command-line compiler as an alternative to compiling programs from within the Visual Studio integrated development environment (IDE). diff --git a/docs/visual-basic/language-reference/keywords/arrays-summary.md b/docs/visual-basic/language-reference/keywords/arrays-summary.md index a3c51bea7dedf..3693cf6af0e2c 100644 --- a/docs/visual-basic/language-reference/keywords/arrays-summary.md +++ b/docs/visual-basic/language-reference/keywords/arrays-summary.md @@ -11,11 +11,11 @@ Visual Basic language keywords and run-time library members are organized by pur |Action|Language element| |------------|----------------------| |Verify an array.|| -|Declare and initialize an array.|[Dim](../../../visual-basic/language-reference/statements/dim-statement.md), [Private](../../../visual-basic/language-reference/modifiers/private.md), [Public](../../../visual-basic/language-reference/modifiers/public.md), [ReDim](../../../visual-basic/language-reference/statements/redim-statement.md)| +|Declare and initialize an array.|[Dim](../statements/dim-statement.md), [Private](../modifiers/private.md), [Public](../modifiers/public.md), [ReDim](../statements/redim-statement.md)| |Find the limits of an array.|, | -|Reinitialize an array|[Erase](../../../visual-basic/language-reference/statements/erase-statement.md), [ReDim](../../../visual-basic/language-reference/statements/redim-statement.md)| +|Reinitialize an array|[Erase](../statements/erase-statement.md), [ReDim](../statements/redim-statement.md)| ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/collection-object-summary.md b/docs/visual-basic/language-reference/keywords/collection-object-summary.md index e2f4ec67284df..058d43899e617 100644 --- a/docs/visual-basic/language-reference/keywords/collection-object-summary.md +++ b/docs/visual-basic/language-reference/keywords/collection-object-summary.md @@ -18,5 +18,5 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/control-flow-summary.md b/docs/visual-basic/language-reference/keywords/control-flow-summary.md index 3f10a4303277c..d98885c01f7df 100644 --- a/docs/visual-basic/language-reference/keywords/control-flow-summary.md +++ b/docs/visual-basic/language-reference/keywords/control-flow-summary.md @@ -10,13 +10,13 @@ Visual Basic language keywords and run-time library members are organized by pur |Action|Language element| |------------|----------------------| -|Branch.|[GoTo](../../../visual-basic/language-reference/statements/goto-statement.md), [On Error](../../../visual-basic/language-reference/statements/on-error-statement.md)| -|Exit or pause the program.|[End](../../../visual-basic/language-reference/statements/end-statement.md), [Exit](../../../visual-basic/language-reference/statements/exit-statement.md), [Stop](../../../visual-basic/language-reference/statements/stop-statement.md)| -|Loop.|[Do...Loop](../../../visual-basic/language-reference/statements/do-loop-statement.md), [For...Next](../../../visual-basic/language-reference/statements/for-next-statement.md), [For Each...Next](../../../visual-basic/language-reference/statements/for-each-next-statement.md), [While...End While](../../../visual-basic/language-reference/statements/while-end-while-statement.md), [With](../../../visual-basic/language-reference/statements/with-end-with-statement.md)| -|Make decisions.|, [If...Then...Else](../../../visual-basic/language-reference/statements/if-then-else-statement.md), [Select Case](../../../visual-basic/language-reference/statements/select-case-statement.md), | -|Use procedures.|[Call](../../../visual-basic/language-reference/statements/call-statement.md), [Function](../../../visual-basic/language-reference/statements/function-statement.md), [Property](../../../visual-basic/language-reference/statements/property-statement.md), [Sub](../../../visual-basic/language-reference/statements/sub-statement.md)| +|Branch.|[GoTo](../statements/goto-statement.md), [On Error](../statements/on-error-statement.md)| +|Exit or pause the program.|[End](../statements/end-statement.md), [Exit](../statements/exit-statement.md), [Stop](../statements/stop-statement.md)| +|Loop.|[Do...Loop](../statements/do-loop-statement.md), [For...Next](../statements/for-next-statement.md), [For Each...Next](../statements/for-each-next-statement.md), [While...End While](../statements/while-end-while-statement.md), [With](../statements/with-end-with-statement.md)| +|Make decisions.|, [If...Then...Else](../statements/if-then-else-statement.md), [Select Case](../statements/select-case-statement.md), | +|Use procedures.|[Call](../statements/call-statement.md), [Function](../statements/function-statement.md), [Property](../statements/property-statement.md), [Sub](../statements/sub-statement.md)| ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/conversion-summary.md b/docs/visual-basic/language-reference/keywords/conversion-summary.md index 40e7f6fda19cb..88fb0939fcf3d 100644 --- a/docs/visual-basic/language-reference/keywords/conversion-summary.md +++ b/docs/visual-basic/language-reference/keywords/conversion-summary.md @@ -18,7 +18,7 @@ Visual Basic language keywords and run-time library members are organized by pur |Convert date to serial number.|, | |Convert decimal number to other bases.|, | |Convert number to string.|, | -|Convert one data type to another.|[CBool](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CByte](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CDate](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CDbl](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CDec](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CInt](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CLng](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CSng](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CShort](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CStr](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CType](../../../visual-basic/language-reference/functions/ctype-function.md), , | +|Convert one data type to another.|[CBool](../functions/type-conversion-functions.md), [CByte](../functions/type-conversion-functions.md), [CDate](../functions/type-conversion-functions.md), [CDbl](../functions/type-conversion-functions.md), [CDec](../functions/type-conversion-functions.md), [CInt](../functions/type-conversion-functions.md), [CLng](../functions/type-conversion-functions.md), [CSng](../functions/type-conversion-functions.md), [CShort](../functions/type-conversion-functions.md), [CStr](../functions/type-conversion-functions.md), [CType](../functions/ctype-function.md), , | |Convert date to day, month, weekday, or year.|, , , | |Convert time to hour, minute, or second.|, , | |Convert string to ASCII value.|, | @@ -27,5 +27,5 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/data-types-summary.md b/docs/visual-basic/language-reference/keywords/data-types-summary.md index 6ea5b8eef6413..a0d7c61f078ac 100644 --- a/docs/visual-basic/language-reference/keywords/data-types-summary.md +++ b/docs/visual-basic/language-reference/keywords/data-types-summary.md @@ -10,11 +10,11 @@ Visual Basic language keywords and run-time library members are organized by pur |Action|Language element| |------------|----------------------| -|Convert between data types|[CBool](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CByte](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CChar](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CDate](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CDbl](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CDec](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CInt](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CLng](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CObj](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CShort](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CSng](../../../visual-basic/language-reference/functions/type-conversion-functions.md), [CStr](../../../visual-basic/language-reference/functions/type-conversion-functions.md), , | -|Set intrinsic data types|[Boolean](../../../visual-basic/language-reference/data-types/boolean-data-type.md), [Byte](../../../visual-basic/language-reference/data-types/byte-data-type.md), [Char](../../../visual-basic/language-reference/data-types/char-data-type.md), [Date](../../../visual-basic/language-reference/data-types/date-data-type.md), [Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md), [Double](../../../visual-basic/language-reference/data-types/double-data-type.md), [Integer](../../../visual-basic/language-reference/data-types/integer-data-type.md), [Long](../../../visual-basic/language-reference/data-types/long-data-type.md), [Object](../../../visual-basic/language-reference/data-types/object-data-type.md), [Short](../../../visual-basic/language-reference/data-types/short-data-type.md), [Single](../../../visual-basic/language-reference/data-types/single-data-type.md), [String](../../../visual-basic/language-reference/data-types/string-data-type.md)| +|Convert between data types|[CBool](../functions/type-conversion-functions.md), [CByte](../functions/type-conversion-functions.md), [CChar](../functions/type-conversion-functions.md), [CDate](../functions/type-conversion-functions.md), [CDbl](../functions/type-conversion-functions.md), [CDec](../functions/type-conversion-functions.md), [CInt](../functions/type-conversion-functions.md), [CLng](../functions/type-conversion-functions.md), [CObj](../functions/type-conversion-functions.md), [CShort](../functions/type-conversion-functions.md), [CSng](../functions/type-conversion-functions.md), [CStr](../functions/type-conversion-functions.md), , | +|Set intrinsic data types|[Boolean](../data-types/boolean-data-type.md), [Byte](../data-types/byte-data-type.md), [Char](../data-types/char-data-type.md), [Date](../data-types/date-data-type.md), [Decimal](../data-types/decimal-data-type.md), [Double](../data-types/double-data-type.md), [Integer](../data-types/integer-data-type.md), [Long](../data-types/long-data-type.md), [Object](../data-types/object-data-type.md), [Short](../data-types/short-data-type.md), [Single](../data-types/single-data-type.md), [String](../data-types/string-data-type.md)| |Verify data types|, , , , , , | ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/dates-and-times-summary.md b/docs/visual-basic/language-reference/keywords/dates-and-times-summary.md index 0c6d3fd67a186..7b158a539b013 100644 --- a/docs/visual-basic/language-reference/keywords/dates-and-times-summary.md +++ b/docs/visual-basic/language-reference/keywords/dates-and-times-summary.md @@ -25,5 +25,5 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/declarations-and-constants-summary.md b/docs/visual-basic/language-reference/keywords/declarations-and-constants-summary.md index ab4367b6f7cd4..a730b60a2dd38 100644 --- a/docs/visual-basic/language-reference/keywords/declarations-and-constants-summary.md +++ b/docs/visual-basic/language-reference/keywords/declarations-and-constants-summary.md @@ -12,17 +12,17 @@ Visual Basic language keywords and run-time library members are organized by pur |Action|Language element| |------------|----------------------| -|Assign a value.|[Get](../../../visual-basic/language-reference/statements/get-statement.md), [Property](../../../visual-basic/language-reference/statements/property-statement.md)| -|Declare variables or constants.|[Const](../../../visual-basic/language-reference/statements/const-statement.md), [Dim](../../../visual-basic/language-reference/statements/dim-statement.md), [Private](../../../visual-basic/language-reference/modifiers/private.md), [Protected](../../../visual-basic/language-reference/modifiers/protected.md), [Public](../../../visual-basic/language-reference/modifiers/public.md), [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md), [Shared](../../../visual-basic/language-reference/modifiers/shared.md), [Static](../../../visual-basic/language-reference/modifiers/static.md)| -|Declare a class, delegate, enumeration, module, namespace, or structure.|[Class](../../../visual-basic/language-reference/statements/class-statement.md), [Delegate](../../../visual-basic/language-reference/statements/delegate-statement.md), [Enum](../../../visual-basic/language-reference/statements/enum-statement.md), [Module](../../../visual-basic/language-reference/statements/module-statement.md), [Namespace](../../../visual-basic/language-reference/statements/namespace-statement.md), [Structure](../../../visual-basic/language-reference/statements/structure-statement.md)| -|Create objects.|, , [New](../../../visual-basic/language-reference/operators/new-operator.md)| -|Get information about an object.|[GetType](../../../visual-basic/language-reference/operators/gettype-operator.md), , , , , , , , , , , | -|Refer to the current object.|[Me](../../../visual-basic/programming-guide/program-structure/me-my-mybase-and-myclass.md)| -|Require explicit variable declarations.|[Option Explicit](../../../visual-basic/language-reference/statements/option-explicit-statement.md), [Option Strict](../../../visual-basic/language-reference/statements/option-strict-statement.md)| -|Handle events.|[AddHandler](../../../visual-basic/language-reference/statements/addhandler-statement.md), [Event](../../../visual-basic/language-reference/statements/event-statement.md), [RaiseEvent](../../../visual-basic/language-reference/statements/raiseevent-statement.md), [RemoveHandler](../../../visual-basic/language-reference/statements/removehandler-statement.md)| -|Implement inheritance.|[Inherits](../../../visual-basic/language-reference/statements/inherits-statement.md), [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md), [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md), [MyBase](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md), [MyClass](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md), [New](../../../visual-basic/language-reference/operators/new-operator.md), [NotInheritable](../../../visual-basic/language-reference/modifiers/notinheritable.md), [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md), [Overloads](../../../visual-basic/language-reference/modifiers/overloads.md), [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md), [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md)| +|Assign a value.|[Get](../statements/get-statement.md), [Property](../statements/property-statement.md)| +|Declare variables or constants.|[Const](../statements/const-statement.md), [Dim](../statements/dim-statement.md), [Private](../modifiers/private.md), [Protected](../modifiers/protected.md), [Public](../modifiers/public.md), [Shadows](../modifiers/shadows.md), [Shared](../modifiers/shared.md), [Static](../modifiers/static.md)| +|Declare a class, delegate, enumeration, module, namespace, or structure.|[Class](../statements/class-statement.md), [Delegate](../statements/delegate-statement.md), [Enum](../statements/enum-statement.md), [Module](../statements/module-statement.md), [Namespace](../statements/namespace-statement.md), [Structure](../statements/structure-statement.md)| +|Create objects.|, , [New](../operators/new-operator.md)| +|Get information about an object.|[GetType](../operators/gettype-operator.md), , , , , , , , , , , | +|Refer to the current object.|[Me](../../programming-guide/program-structure/me-my-mybase-and-myclass.md)| +|Require explicit variable declarations.|[Option Explicit](../statements/option-explicit-statement.md), [Option Strict](../statements/option-strict-statement.md)| +|Handle events.|[AddHandler](../statements/addhandler-statement.md), [Event](../statements/event-statement.md), [RaiseEvent](../statements/raiseevent-statement.md), [RemoveHandler](../statements/removehandler-statement.md)| +|Implement inheritance.|[Inherits](../statements/inherits-statement.md), [MustInherit](../modifiers/mustinherit.md), [MustOverride](../modifiers/mustoverride.md), [MyBase](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md), [MyClass](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md), [New](../operators/new-operator.md), [NotInheritable](../modifiers/notinheritable.md), [NotOverridable](../modifiers/notoverridable.md), [Overloads](../modifiers/overloads.md), [Overridable](../modifiers/overridable.md), [Overrides](../modifiers/overrides.md)| ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/derived-math-functions.md b/docs/visual-basic/language-reference/keywords/derived-math-functions.md index 9494d4c33a905..6440d7bef053c 100644 --- a/docs/visual-basic/language-reference/keywords/derived-math-functions.md +++ b/docs/visual-basic/language-reference/keywords/derived-math-functions.md @@ -50,4 +50,4 @@ The following table shows non-intrinsic math functions that can be derived from ## See also -- [Math Functions](../../../visual-basic/language-reference/functions/math-functions.md) +- [Math Functions](../functions/math-functions.md) diff --git a/docs/visual-basic/language-reference/keywords/directories-and-files-summary.md b/docs/visual-basic/language-reference/keywords/directories-and-files-summary.md index 2262408dcbad9..9c82dddea766a 100644 --- a/docs/visual-basic/language-reference/keywords/directories-and-files-summary.md +++ b/docs/visual-basic/language-reference/keywords/directories-and-files-summary.md @@ -29,9 +29,9 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) -- [Reading from Files](../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md) -- [Writing to Files](../../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) -- [Creating, Deleting, and Moving Files and Directories](../../../visual-basic/developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md) -- [Parsing Text Files with the TextFieldParser Object](../../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) +- [Reading from Files](../../developing-apps/programming/drives-directories-files/reading-from-files.md) +- [Writing to Files](../../developing-apps/programming/drives-directories-files/writing-to-files.md) +- [Creating, Deleting, and Moving Files and Directories](../../developing-apps/programming/drives-directories-files/creating-deleting-and-moving-files-and-directories.md) +- [Parsing Text Files with the TextFieldParser Object](../../developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) diff --git a/docs/visual-basic/language-reference/keywords/errors-summary.md b/docs/visual-basic/language-reference/keywords/errors-summary.md index e04fd43cfe0fb..52f995fad9a9d 100644 --- a/docs/visual-basic/language-reference/keywords/errors-summary.md +++ b/docs/visual-basic/language-reference/keywords/errors-summary.md @@ -10,14 +10,14 @@ Visual Basic language keywords and run-time library members are organized by pur |Action|Language element| |------------|----------------------| -|Generate run-time errors.|, [Error](../../../visual-basic/language-reference/statements/error-statement.md), | +|Generate run-time errors.|, [Error](../statements/error-statement.md), | |Get exceptions.|| |Provide error information.|| -|Trap errors during run time.|[On Error](../../../visual-basic/language-reference/statements/on-error-statement.md), [Resume](../../../visual-basic/language-reference/statements/resume-statement.md), [Try...Catch...Finally](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md)| +|Trap errors during run time.|[On Error](../statements/on-error-statement.md), [Resume](../statements/resume-statement.md), [Try...Catch...Finally](../statements/try-catch-finally-statement.md)| |Provide line number of error.|| |Provide system error code.|| ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/financial-summary.md b/docs/visual-basic/language-reference/keywords/financial-summary.md index 7d61534c9fcc6..5b94fa1c77c98 100644 --- a/docs/visual-basic/language-reference/keywords/financial-summary.md +++ b/docs/visual-basic/language-reference/keywords/financial-summary.md @@ -21,5 +21,5 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/index.md b/docs/visual-basic/language-reference/keywords/index.md index ad010383eda16..ad19b8ce8961d 100644 --- a/docs/visual-basic/language-reference/keywords/index.md +++ b/docs/visual-basic/language-reference/keywords/index.md @@ -17,7 +17,7 @@ The following tables list all Visual Basic language keywords. ## Reserved Keywords -The following keywords are *reserved*, which means that you cannot use them as names for programming elements such as variables or procedures. You can bypass this restriction by enclosing the name in brackets (`[]`). For more information, see "Escaped Names" in [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). +The following keywords are *reserved*, which means that you cannot use them as names for programming elements such as variables or procedures. You can bypass this restriction by enclosing the name in brackets (`[]`). For more information, see "Escaped Names" in [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). > [!NOTE] > We do not recommend that you use escaped names, because it can make your code hard to read, and it can lead to subtle errors that can be difficult to find. @@ -40,17 +40,17 @@ The following keywords are *reserved*, which means that you cannot use them as n |[Error](../statements/on-error-statement.md)|[Event](../statements/event-statement.md)|[Exit](../statements/exit-statement.md)|[False](../data-types/boolean-data-type.md)| |[Finally](../statements/try-catch-finally-statement.md)|[For (in For…Next)](../statements/for-next-statement.md)|[For Each…Next](../statements/for-each-next-statement.md)|[Friend](../modifiers/friend.md)| |[Function](../statements/function-statement.md)|[Get](../statements/get-statement.md)|[GetType](../operators/gettype-operator.md)|[GetXMLNamespace](../operators/getxmlnamespace-operator.md)| -|[Global](../../../visual-basic/programming-guide/program-structure/namespaces.md)|`GoSub`|[GoTo](../statements/goto-statement.md)|[Handles](../statements/handles-clause.md)| +|[Global](../../programming-guide/program-structure/namespaces.md)|`GoSub`|[GoTo](../statements/goto-statement.md)|[Handles](../statements/handles-clause.md)| |[If](../statements/if-then-else-statement.md)|[If()](../operators/if-operator.md)|[Implements](../statements/implements-clause.md)|[Implements Statement](../statements/implements-statement.md)| |[Imports (.NET Namespace and Type)](../statements/imports-statement-net-namespace-and-type.md)|[Imports (XML Namespace)](../statements/imports-statement-xml-namespace.md)|[In](../statements/in-clause.md)|[In (Generic Modifier)](../modifiers/in-generic-modifier.md)| |[Inherits](../statements/inherits-statement.md)|[Integer](../data-types/integer-data-type.md)|[Interface](../statements/interface-statement.md)|[Is](../operators/is-operator.md)| |[IsNot](../operators/isnot-operator.md)|[Let](../queries/let-clause.md)|[Lib](../statements/declare-statement.md)|[Like](../operators/like-operator.md)| -|[Long](../data-types/long-data-type.md)|[Loop](../statements/do-loop-statement.md)|[Me](../../../visual-basic/programming-guide/program-structure/me-my-mybase-and-myclass.md)|[Mod](../operators/mod-operator.md)| +|[Long](../data-types/long-data-type.md)|[Loop](../statements/do-loop-statement.md)|[Me](../../programming-guide/program-structure/me-my-mybase-and-myclass.md)|[Mod](../operators/mod-operator.md)| |[Module](../modifiers/module-keyword.md)|[Module Statement](../statements/module-statement.md)|[MustInherit](../modifiers/mustinherit.md)|[MustOverride](../modifiers/mustoverride.md)| -|[MyBase](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md)|[MyClass](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md)|[NameOf](../operators/nameof.md)|[Namespace](../statements/namespace-statement.md)| +|[MyBase](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md)|[MyClass](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md)|[NameOf](../operators/nameof.md)|[Namespace](../statements/namespace-statement.md)| |[Narrowing](../modifiers/narrowing.md)|[New Constraint](../statements/type-list.md)|[New Operator](../operators/new-operator.md)|[Next](../statements/for-next-statement.md)| |[Next (in Resume)](../statements/resume-statement.md)|[Not](../operators/not-operator.md)|[Nothing](../nothing.md)|[NotInheritable](../modifiers/notinheritable.md)| -|[NotOverridable](../modifiers/notoverridable.md)|[Object](../data-types/object-data-type.md)|[Of](../statements/of-clause.md)|[On](../../../visual-basic/misc/on.md)| +|[NotOverridable](../modifiers/notoverridable.md)|[Object](../data-types/object-data-type.md)|[Of](../statements/of-clause.md)|[On](../../misc/on.md)| |[Operator](../statements/operator-statement.md)|[Option](../statements/option-keyword-statement.md)|[Optional](../modifiers/optional.md)|[Or](../operators/or-operator.md)| |[OrElse](../operators/orelse-operator.md)|[Out (Generic Modifier)](../modifiers/out-generic-modifier.md)|[Overloads](../modifiers/overloads.md)|[Overridable](../modifiers/overridable.md)| |[Overrides](../modifiers/overrides.md)|[ParamArray](../modifiers/paramarray.md)|[Partial](../modifiers/partial.md)|[Private](../modifiers/private.md)| @@ -87,7 +87,7 @@ The following keywords are not reserved, which means you can use them as names f |[Custom](../statements/event-statement.md)|[Distinct](../queries/distinct-clause.md)|[Equals](../queries/equals-clause.md)|[Explicit](../statements/option-explicit-statement.md)| |[From](../queries/from-clause.md)|[Group By](../queries/group-by-clause.md)|[Group Join](../queries/group-join-clause.md)|[Into](../statements/into-clause.md)| |[IsFalse](../operators/isfalse-operator.md)|[IsTrue](../operators/istrue-operator.md)|[Iterator](../modifiers/iterator.md)|[Join](../queries/join-clause.md)| -|[Key](../modifiers/key.md)|[Mid](../statements/mid-statement.md)|[Off](../../../visual-basic/misc/off.md)|[Order By](../queries/order-by-clause.md)| +|[Key](../modifiers/key.md)|[Mid](../statements/mid-statement.md)|[Off](../../misc/off.md)|[Order By](../queries/order-by-clause.md)| |[Preserve](../statements/redim-statement.md)|[Skip](../queries/skip-clause.md)|[Skip While](../queries/skip-while-clause.md)|[Strict](../statements/option-strict-statement.md)| |[Take](../queries/take-clause.md)|[Take While](../queries/take-while-clause.md)|[Text](../statements/option-compare-statement.md)|[Unicode](../modifiers/unicode.md)| |[Until](../statements/do-loop-statement.md)|[Where](../queries/where-clause.md)|[Yield](../statements/yield-statement.md)|[#ExternalSource](../directives/externalsource-directive.md)| diff --git a/docs/visual-basic/language-reference/keywords/information-and-interaction-summary.md b/docs/visual-basic/language-reference/keywords/information-and-interaction-summary.md index aab85433d87fa..e4d593eae193e 100644 --- a/docs/visual-basic/language-reference/keywords/information-and-interaction-summary.md +++ b/docs/visual-basic/language-reference/keywords/information-and-interaction-summary.md @@ -21,5 +21,5 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/input-and-output-summary.md b/docs/visual-basic/language-reference/keywords/input-and-output-summary.md index 9f3c239a64ead..4df7bae37f779 100644 --- a/docs/visual-basic/language-reference/keywords/input-and-output-summary.md +++ b/docs/visual-basic/language-reference/keywords/input-and-output-summary.md @@ -27,5 +27,5 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/math-summary.md b/docs/visual-basic/language-reference/keywords/math-summary.md index 99c04fe684554..e7352ec0afe4d 100644 --- a/docs/visual-basic/language-reference/keywords/math-summary.md +++ b/docs/visual-basic/language-reference/keywords/math-summary.md @@ -22,6 +22,6 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Derived Math Functions](../../../visual-basic/language-reference/keywords/derived-math-functions.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Derived Math Functions](derived-math-functions.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/my-reference.md b/docs/visual-basic/language-reference/keywords/my-reference.md index 42d10197f196a..eeb0629c7c779 100644 --- a/docs/visual-basic/language-reference/keywords/my-reference.md +++ b/docs/visual-basic/language-reference/keywords/my-reference.md @@ -13,16 +13,16 @@ The `My` feature makes programming faster and easier by giving you intuitive acc |----------------|----------------| |Accessing application information and services.|The `My.Application` object consists of the following classes:

provides members that are available in all projects.

provides members available in Windows Forms applications.

provides members available in console applications.| |Accessing the host computer and its resources, services, and data.|`My.Computer` ()| -|Accessing the forms in the current project.|[My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md)| +|Accessing the forms in the current project.|[My.Forms Object](../objects/my-forms-object.md)| |Accessing the application log.|`My.Application.Log` ()| -|Accessing the current web request.|[My.Request Object](../../../visual-basic/language-reference/objects/my-request-object.md)| -|Accessing resource elements.|[My.Resources Object](../../../visual-basic/language-reference/objects/my-resources-object.md)| -|Accessing the current web response.|[My.Response Object](../../../visual-basic/language-reference/objects/my-response-object.md)| -|Accessing user and application level settings.|[My.Settings Object](../../../visual-basic/language-reference/objects/my-settings-object.md)| +|Accessing the current web request.|[My.Request Object](../objects/my-request-object.md)| +|Accessing resource elements.|[My.Resources Object](../objects/my-resources-object.md)| +|Accessing the current web response.|[My.Response Object](../objects/my-response-object.md)| +|Accessing user and application level settings.|[My.Settings Object](../objects/my-settings-object.md)| |Accessing the current user's security context.|`My.User` ()| -|Accessing XML Web services referenced by the current project.|[My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md)| +|Accessing XML Web services referenced by the current project.|[My.WebServices Object](../objects/my-webservices-object.md)| ## See also -- [Overview of the Visual Basic Application Model](../../../visual-basic/developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md) -- [Development with My](../../../visual-basic/developing-apps/development-with-my/index.md) +- [Overview of the Visual Basic Application Model](../../developing-apps/development-with-my/overview-of-the-visual-basic-application-model.md) +- [Development with My](../../developing-apps/development-with-my/index.md) diff --git a/docs/visual-basic/language-reference/keywords/operators-summary.md b/docs/visual-basic/language-reference/keywords/operators-summary.md index 4aab43220656e..44ac87c813604 100644 --- a/docs/visual-basic/language-reference/keywords/operators-summary.md +++ b/docs/visual-basic/language-reference/keywords/operators-summary.md @@ -12,14 +12,14 @@ Visual Basic language keywords and run-time library members are organized by pur |Action|Language element| |------------|----------------------| -|Arithmetic|[^](../../../visual-basic/language-reference/operators/exponentiation-operator.md), [–](../../../visual-basic/language-reference/operators/subtraction-operator.md), [*](../../../visual-basic/language-reference/operators/multiplication-operator.md), [/](../../../visual-basic/language-reference/operators/floating-point-division-operator.md), [\\](../../../visual-basic/language-reference/operators/integer-division-operator.md), [Mod](../../../visual-basic/language-reference/operators/mod-operator.md), [+](../../../visual-basic/language-reference/operators/addition-operator.md), [=](../../../visual-basic/language-reference/operators/assignment-operator.md)| -|Assignment|[=](../../../visual-basic/language-reference/operators/assignment-operator.md), [^=](../../../visual-basic/language-reference/operators/exponentiation-assignment-operator.md), [*=](../../../visual-basic/language-reference/operators/multiplication-assignment-operator.md), [/=](../../../visual-basic/language-reference/operators/floating-point-division-assignment-operator.md), [\\=](../../../visual-basic/language-reference/operators/integer-division-assignment-operator.md), [+=](../../../visual-basic/language-reference/operators/addition-assignment-operator.md), [-=](../../../visual-basic/language-reference/operators/subtraction-assignment-operator.md), [&=](../../../visual-basic/language-reference/operators/and-assignment-operator.md)| -|Comparison|[=](../../../visual-basic/language-reference/operators/comparison-operators.md), [<>](../../../visual-basic/language-reference/operators/comparison-operators.md), [\<](../../../visual-basic/language-reference/operators/comparison-operators.md), [>](../../../visual-basic/language-reference/operators/comparison-operators.md), [\<=](../../../visual-basic/language-reference/operators/comparison-operators.md), [>=](../../../visual-basic/language-reference/operators/comparison-operators.md), [Like](../../../visual-basic/language-reference/operators/like-operator.md), [Is](../../../visual-basic/language-reference/operators/is-operator.md)| -|Concatenation|[&](../../../visual-basic/language-reference/operators/concatenation-operator.md), [+](../../../visual-basic/language-reference/operators/addition-operator.md)| -|Logical/bitwise operations|[Not](../../../visual-basic/language-reference/operators/not-operator.md), [And](../../../visual-basic/language-reference/operators/and-operator.md), [Or](../../../visual-basic/language-reference/operators/or-operator.md), [Xor](../../../visual-basic/language-reference/operators/xor-operator.md), [AndAlso](../../../visual-basic/language-reference/operators/andalso-operator.md), [OrElse](../../../visual-basic/language-reference/operators/orelse-operator.md)| -|Miscellaneous operations|[AddressOf](../../../visual-basic/language-reference/operators/addressof-operator.md), [Await](../../../visual-basic/language-reference/operators/await-operator.md), [GetType](../../../visual-basic/language-reference/operators/gettype-operator.md)| +|Arithmetic|[^](../operators/exponentiation-operator.md), [–](../operators/subtraction-operator.md), [*](../operators/multiplication-operator.md), [/](../operators/floating-point-division-operator.md), [\\](../operators/integer-division-operator.md), [Mod](../operators/mod-operator.md), [+](../operators/addition-operator.md), [=](../operators/assignment-operator.md)| +|Assignment|[=](../operators/assignment-operator.md), [^=](../operators/exponentiation-assignment-operator.md), [*=](../operators/multiplication-assignment-operator.md), [/=](../operators/floating-point-division-assignment-operator.md), [\\=](../operators/integer-division-assignment-operator.md), [+=](../operators/addition-assignment-operator.md), [-=](../operators/subtraction-assignment-operator.md), [&=](../operators/and-assignment-operator.md)| +|Comparison|[=](../operators/comparison-operators.md), [<>](../operators/comparison-operators.md), [\<](../operators/comparison-operators.md), [>](../operators/comparison-operators.md), [\<=](../operators/comparison-operators.md), [>=](../operators/comparison-operators.md), [Like](../operators/like-operator.md), [Is](../operators/is-operator.md)| +|Concatenation|[&](../operators/concatenation-operator.md), [+](../operators/addition-operator.md)| +|Logical/bitwise operations|[Not](../operators/not-operator.md), [And](../operators/and-operator.md), [Or](../operators/or-operator.md), [Xor](../operators/xor-operator.md), [AndAlso](../operators/andalso-operator.md), [OrElse](../operators/orelse-operator.md)| +|Miscellaneous operations|[AddressOf](../operators/addressof-operator.md), [Await](../operators/await-operator.md), [GetType](../operators/gettype-operator.md)| ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/keywords/registry-summary.md b/docs/visual-basic/language-reference/keywords/registry-summary.md index 9512f1aeea0b3..9b51b05cdc9bb 100644 --- a/docs/visual-basic/language-reference/keywords/registry-summary.md +++ b/docs/visual-basic/language-reference/keywords/registry-summary.md @@ -18,6 +18,6 @@ Visual Studio language keywords and run-time library members are organized by pu ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) -- [Reading from and Writing to the Registry](../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) +- [Reading from and Writing to the Registry](../../developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md) diff --git a/docs/visual-basic/language-reference/keywords/string-manipulation-summary.md b/docs/visual-basic/language-reference/keywords/string-manipulation-summary.md index 2d8c3b67f460a..1a760676e0481 100644 --- a/docs/visual-basic/language-reference/keywords/string-manipulation-summary.md +++ b/docs/visual-basic/language-reference/keywords/string-manipulation-summary.md @@ -20,7 +20,7 @@ Visual Basic language keywords and run-time library members are organized by pur |Find the length of a string.|| |Format a string.|, , , , | |Manipulate strings.|, , , , , , | -|Set string comparison rules.|[Option Compare](../../../visual-basic/language-reference/statements/option-compare-statement.md)| +|Set string comparison rules.|[Option Compare](../statements/option-compare-statement.md)| |Work with ASCII and ANSI values.|, , , | |Replace a specified substring.|| |Return a filter-based string array.|| @@ -28,5 +28,5 @@ Visual Basic language keywords and run-time library members are organized by pur ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../../visual-basic/language-reference/runtime-library-members.md) +- [Keywords](index.md) +- [Visual Basic Runtime Library Members](../runtime-library-members.md) diff --git a/docs/visual-basic/language-reference/modifiers/ansi.md b/docs/visual-basic/language-reference/modifiers/ansi.md index d992633bd896f..ce91b7cb88bcc 100644 --- a/docs/visual-basic/language-reference/modifiers/ansi.md +++ b/docs/visual-basic/language-reference/modifiers/ansi.md @@ -12,7 +12,7 @@ ms.assetid: 4f1fa6ff-5557-41ab-b6da-90baf4c15917 # Ansi (Visual Basic) Specifies that Visual Basic should marshal all strings to American National Standards Institute (ANSI) values regardless of the name of the external procedure being declared. - When you call a procedure defined outside your project, the Visual Basic compiler does not have access to the information it needs to call the procedure correctly. This information includes where the procedure is located, how it is identified, its calling sequence and return type, and the string character set it uses. The [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) creates a reference to an external procedure and supplies this necessary information. + When you call a procedure defined outside your project, the Visual Basic compiler does not have access to the information it needs to call the procedure correctly. This information includes where the procedure is located, how it is identified, its calling sequence and return type, and the string character set it uses. The [Declare Statement](../statements/declare-statement.md) creates a reference to an external procedure and supplies this necessary information. The `charsetmodifier` part in the `Declare` statement supplies the character set information for marshaling strings during a call to the external procedure. It also affects how Visual Basic searches the external file for the external procedure name. The `Ansi` modifier specifies that Visual Basic should marshal all strings to ANSI values and should look up the procedure without modifying its name during the search. @@ -21,13 +21,13 @@ Specifies that Visual Basic should marshal all strings to American National Stan ## Remarks The `Ansi` modifier can be used in this context: - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) ## Smart Device Developer Notes This keyword is not supported. ## See also -- [Auto](../../../visual-basic/language-reference/modifiers/auto.md) -- [Unicode](../../../visual-basic/language-reference/modifiers/unicode.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Auto](auto.md) +- [Unicode](unicode.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/assembly.md b/docs/visual-basic/language-reference/modifiers/assembly.md index 4d237a3ea1666..85bb8a6d125c2 100644 --- a/docs/visual-basic/language-reference/modifiers/assembly.md +++ b/docs/visual-basic/language-reference/modifiers/assembly.md @@ -17,11 +17,11 @@ Specifies that an attribute at the beginning of a source file applies to the ent ## Remarks Many attributes pertain to an individual programming element, such as a class or property. You apply such an attribute by attaching the attribute block, within angle brackets (`< >`), directly to the declaration statement. - If an attribute pertains not only to the following element but to the entire assembly, you place the attribute block at the beginning of the source file and identify the attribute with the `Assembly` keyword. If it applies to the current assembly module, you use the [Module](../../../visual-basic/language-reference/modifiers/module-keyword.md) keyword. + If an attribute pertains not only to the following element but to the entire assembly, you place the attribute block at the beginning of the source file and identify the attribute with the `Assembly` keyword. If it applies to the current assembly module, you use the [Module](module-keyword.md) keyword. You can also apply an attribute to an assembly in the AssemblyInfo.vb file, in which case you do not have to use an attribute block in your main source-code file. ## See also -- [Module \](../../../visual-basic/language-reference/modifiers/module-keyword.md) -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) +- [Module \](module-keyword.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/async.md b/docs/visual-basic/language-reference/modifiers/async.md index f0a43cf735041..71ba420a7eac0 100644 --- a/docs/visual-basic/language-reference/modifiers/async.md +++ b/docs/visual-basic/language-reference/modifiers/async.md @@ -10,12 +10,12 @@ ms.assetid: 1be8b4b5-9689-41b5-bd33-b906bfd53bc5 --- # Async (Visual Basic) -The `Async` modifier indicates that the method or [lambda expression](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md) that it modifies is asynchronous. Such methods are referred to as *async methods*. +The `Async` modifier indicates that the method or [lambda expression](../../programming-guide/language-features/procedures/lambda-expressions.md) that it modifies is asynchronous. Such methods are referred to as *async methods*. An async method provides a convenient way to do potentially long-running work without blocking the caller's thread. The caller of an async method can resume its work without waiting for the async method to finish. > [!NOTE] -> The `Async` and `Await` keywords were introduced in Visual Studio 2012. For an introduction to async programming, see [Asynchronous Programming with Async and Await](../../../visual-basic/programming-guide/concepts/async/index.md). +> The `Async` and `Await` keywords were introduced in Visual Studio 2012. For an introduction to async programming, see [Asynchronous Programming with Async and Await](../../programming-guide/concepts/async/index.md). The following example shows the structure of an async method. By convention, async method names end in "Async." @@ -37,23 +37,23 @@ Public Async Function ExampleMethodAsync() As Task(Of Integer) End Function ``` -Typically, a method modified by the `Async` keyword contains at least one [Await](../../../visual-basic/language-reference/modifiers/async.md) expression or statement. The method runs synchronously until it reaches the first `Await`, at which point it suspends until the awaited task completes. In the meantime, control is returned to the caller of the method. If the method doesn't contain an `Await` expression or statement, the method isn't suspended and executes as a synchronous method does. A compiler warning alerts you to any async methods that don't contain `Await` because that situation might indicate an error. For more information, see the [compiler error](../error-messages/bc42358.md). +Typically, a method modified by the `Async` keyword contains at least one [Await](async.md) expression or statement. The method runs synchronously until it reaches the first `Await`, at which point it suspends until the awaited task completes. In the meantime, control is returned to the caller of the method. If the method doesn't contain an `Await` expression or statement, the method isn't suspended and executes as a synchronous method does. A compiler warning alerts you to any async methods that don't contain `Await` because that situation might indicate an error. For more information, see the [compiler error](../error-messages/bc42358.md). The `Async` keyword is an unreserved keyword. It is a keyword when it modifies a method or a lambda expression. In all other contexts, it is interpreted as an identifier. ## Return Types -An async method is either a [Sub](../../../visual-basic/programming-guide/language-features/procedures/sub-procedures.md) procedure, or a [Function](../../../visual-basic/programming-guide/language-features/procedures/function-procedures.md) procedure that has a return type of or . The method cannot declare any [ByRef](../../../visual-basic/language-reference/modifiers/byref.md) parameters. +An async method is either a [Sub](../../programming-guide/language-features/procedures/sub-procedures.md) procedure, or a [Function](../../programming-guide/language-features/procedures/function-procedures.md) procedure that has a return type of or . The method cannot declare any [ByRef](byref.md) parameters. -You specify `Task(Of TResult)` for the return type of an async method if the [Return](../../../visual-basic/language-reference/statements/return-statement.md) statement of the method has an operand of type TResult. You use `Task` if no meaningful value is returned when the method is completed. That is, a call to the method returns a `Task`, but when the `Task` is completed, any `Await` statement that's awaiting the `Task` doesn’t produce a result value. +You specify `Task(Of TResult)` for the return type of an async method if the [Return](../statements/return-statement.md) statement of the method has an operand of type TResult. You use `Task` if no meaningful value is returned when the method is completed. That is, a call to the method returns a `Task`, but when the `Task` is completed, any `Await` statement that's awaiting the `Task` doesn’t produce a result value. Async subroutines are used primarily to define event handlers where a `Sub` procedure is required. The caller of an async subroutine can't await it and can't catch exceptions that the method throws. -For more information and examples, see [Async Return Types](../../../visual-basic/programming-guide/concepts/async/async-return-types.md). +For more information and examples, see [Async Return Types](../../programming-guide/concepts/async/async-return-types.md). ## Example -The following examples show an async event handler, an async lambda expression, and an async method. For a full example that uses these elements, see [Walkthrough: Accessing the Web by Using Async and Await](../../../visual-basic/programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md). You can download the walkthrough code from [Developer Code Samples](https://code.msdn.microsoft.com/Async-Sample-Accessing-the-9c10497f). +The following examples show an async event handler, an async lambda expression, and an async method. For a full example that uses these elements, see [Walkthrough: Accessing the Web by Using Async and Await](../../programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md). You can download the walkthrough code from [Developer Code Samples](https://code.msdn.microsoft.com/Async-Sample-Accessing-the-9c10497f). ```vb ' An event handler must be a Sub procedure. @@ -103,6 +103,6 @@ End Function ## See also - -- [Await Operator](../../../visual-basic/language-reference/operators/await-operator.md) -- [Asynchronous Programming with Async and Await](../../../visual-basic/programming-guide/concepts/async/index.md) -- [Walkthrough: Accessing the Web by Using Async and Await](../../../visual-basic/programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md) +- [Await Operator](../operators/await-operator.md) +- [Asynchronous Programming with Async and Await](../../programming-guide/concepts/async/index.md) +- [Walkthrough: Accessing the Web by Using Async and Await](../../programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md) diff --git a/docs/visual-basic/language-reference/modifiers/auto.md b/docs/visual-basic/language-reference/modifiers/auto.md index d910ecef1ff51..0422ff2ad6c6b 100644 --- a/docs/visual-basic/language-reference/modifiers/auto.md +++ b/docs/visual-basic/language-reference/modifiers/auto.md @@ -13,22 +13,22 @@ ms.assetid: bf79ba95-a62c-48a5-916f-0ac7a52c13ec # Auto (Visual Basic) Specifies that Visual Basic should marshal strings according to .NET Framework rules based on the external name of the external procedure being declared. - When you call a procedure defined outside your project, the Visual Basic compiler does not have access to the information it must have to call the procedure correctly. This information includes where the procedure is located, how it is identified, its calling sequence and return type, and the string character set it uses. The [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) creates a reference to an external procedure and supplies this necessary information. + When you call a procedure defined outside your project, the Visual Basic compiler does not have access to the information it must have to call the procedure correctly. This information includes where the procedure is located, how it is identified, its calling sequence and return type, and the string character set it uses. The [Declare Statement](../statements/declare-statement.md) creates a reference to an external procedure and supplies this necessary information. - The `charsetmodifier` part in the `Declare` statement supplies the character set information for marshaling strings during a call to the external procedure. It also affects how Visual Basic searches the external file for the external procedure name. The `Auto` modifier specifies that Visual Basic should marshal strings according to .NET Framework rules, and that it should determine the base character set of the run-time platform and possibly modify the external procedure name if the initial search fails. For more information, see "Character Sets" in [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md). + The `charsetmodifier` part in the `Declare` statement supplies the character set information for marshaling strings during a call to the external procedure. It also affects how Visual Basic searches the external file for the external procedure name. The `Auto` modifier specifies that Visual Basic should marshal strings according to .NET Framework rules, and that it should determine the base character set of the run-time platform and possibly modify the external procedure name if the initial search fails. For more information, see "Character Sets" in [Declare Statement](../statements/declare-statement.md). If no character set modifier is specified, `Ansi` is the default. ## Remarks The `Auto` modifier can be used in this context: - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) ## Smart Device Developer Notes This keyword is not supported. ## See also -- [Ansi](../../../visual-basic/language-reference/modifiers/ansi.md) -- [Unicode](../../../visual-basic/language-reference/modifiers/unicode.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Ansi](ansi.md) +- [Unicode](unicode.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/byref.md b/docs/visual-basic/language-reference/modifiers/byref.md index f9b8bca644b0f..0e90f05855556 100644 --- a/docs/visual-basic/language-reference/modifiers/byref.md +++ b/docs/visual-basic/language-reference/modifiers/byref.md @@ -15,13 +15,13 @@ Specifies that an argument is passed in such a way that the called procedure can ## Remarks The `ByRef` modifier can be used in these contexts: - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Passing Arguments by Value and by Reference](../../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Keywords](../keywords/index.md) +- [Passing Arguments by Value and by Reference](../../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/language-reference/modifiers/byval.md b/docs/visual-basic/language-reference/modifiers/byval.md index c977e93ff859b..e0be06a12fa64 100644 --- a/docs/visual-basic/language-reference/modifiers/byval.md +++ b/docs/visual-basic/language-reference/modifiers/byval.md @@ -18,15 +18,15 @@ Specifies that an argument is passed [by value](../../programming-guide/language ## Remarks The `ByVal` modifier can be used in these contexts: - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) + [Operator Statement](../statements/operator-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## Example The following example demonstrates the use of the `ByVal` parameter passing mechanism with a reference type argument. In the example, the argument is `c1`, an instance of class `Class1`. `ByVal` prevents the code in the procedures from changing the underlying value of the reference argument, `c1`, but does not protect the accessible fields and properties of `c1`. @@ -35,5 +35,5 @@ Specifies that an argument is passed [by value](../../programming-guide/language ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Passing Arguments by Value and by Reference](../../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Keywords](../keywords/index.md) +- [Passing Arguments by Value and by Reference](../../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/language-reference/modifiers/default.md b/docs/visual-basic/language-reference/modifiers/default.md index d9caed8ee9c23..6f6d6f81c9ada 100644 --- a/docs/visual-basic/language-reference/modifiers/default.md +++ b/docs/visual-basic/language-reference/modifiers/default.md @@ -19,7 +19,7 @@ Identifies a property as the default property of its class, structure, or interf Default properties can result in a small reduction in source code-characters, but they can make your code more difficult to read. If the calling code is not familiar with your class or structure, when it makes a reference to the class or structure name it cannot be certain whether that reference accesses the class or structure itself, or a default property. This can lead to compiler errors or subtle run-time logic errors. - You can somewhat reduce the chance of default property errors by always using the [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) to set compiler type checking to `On`. + You can somewhat reduce the chance of default property errors by always using the [Option Strict Statement](../statements/option-strict-statement.md) to set compiler type checking to `On`. If you are planning to use a predefined class or structure in your code, you must determine whether it has a default property, and if so, what its name is. @@ -27,9 +27,9 @@ Identifies a property as the default property of its class, structure, or interf The `Default` modifier can be used in this context: - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) ## See also -- [How to: Declare and Call a Default Property in Visual Basic](../../../visual-basic/programming-guide/language-features/procedures/how-to-declare-and-call-a-default-property.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [How to: Declare and Call a Default Property in Visual Basic](../../programming-guide/language-features/procedures/how-to-declare-and-call-a-default-property.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/friend.md b/docs/visual-basic/language-reference/modifiers/friend.md index 397ebc365ce6d..d5db390d4bca5 100644 --- a/docs/visual-basic/language-reference/modifiers/friend.md +++ b/docs/visual-basic/language-reference/modifiers/friend.md @@ -26,7 +26,7 @@ Specifies that one or more declared programming elements are accessible only fro > [!NOTE] > You can also use the [Protected Friend](protected-friend.md) access modifier, which makes a class member accessible from within that class, from derived classes, and from the same assembly in which the class is defined. To restrict access to a member from within its class and from derived classes in the same assembly, you use the [Private Protected](private-protected.md) access modifier. - For a comparison of `Friend` and the other access modifiers, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). + For a comparison of `Friend` and the other access modifiers, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). > [!NOTE] > You can specify that another assembly is a friend assembly, which allows it to access all types and members that are marked as `Friend`. For more information, see [Friend Assemblies](../../../standard/assembly/friend.md). @@ -39,41 +39,41 @@ Specifies that one or more declared programming elements are accessible only fro ## Usage You can use the `Friend` modifier in these contexts: - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](../statements/class-statement.md) - [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) + [Const Statement](../statements/const-statement.md) - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) - [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) + [Delegate Statement](../statements/delegate-statement.md) - [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) + [Dim Statement](../statements/dim-statement.md) - [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) + [Enum Statement](../statements/enum-statement.md) - [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) + [Event Statement](../statements/event-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) + [Interface Statement](../statements/interface-statement.md) - [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md) + [Module Statement](../statements/module-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) + [Structure Statement](../statements/structure-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also - -- [Public](../../../visual-basic/language-reference/modifiers/public.md) -- [Protected](../../../visual-basic/language-reference/modifiers/protected.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) +- [Public](public.md) +- [Protected](protected.md) +- [Private](private.md) - [Private Protected](./private-protected.md) - [Protected Friend](./protected-friend.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/index.md b/docs/visual-basic/language-reference/modifiers/index.md index ad95a1661c5cd..e83054c3a7db2 100644 --- a/docs/visual-basic/language-reference/modifiers/index.md +++ b/docs/visual-basic/language-reference/modifiers/index.md @@ -7,79 +7,79 @@ ms.assetid: a49a0e51-d700-4705-9196-3e0eb582dda6 The topics in this section document Visual Basic run-time modifiers. ## In This Section - [Ansi](../../../visual-basic/language-reference/modifiers/ansi.md) + [Ansi](ansi.md) - [Assembly](../../../visual-basic/language-reference/modifiers/assembly.md) + [Assembly](assembly.md) - [Async](../../../visual-basic/language-reference/modifiers/async.md) + [Async](async.md) - [Auto](../../../visual-basic/language-reference/modifiers/auto.md) + [Auto](auto.md) - [ByRef](../../../visual-basic/language-reference/modifiers/byref.md) + [ByRef](byref.md) - [ByVal](../../../visual-basic/language-reference/modifiers/byval.md) + [ByVal](byval.md) - [Default](../../../visual-basic/language-reference/modifiers/default.md) + [Default](default.md) - [Friend](../../../visual-basic/language-reference/modifiers/friend.md) + [Friend](friend.md) - [In](../../../visual-basic/language-reference/modifiers/in-generic-modifier.md) + [In](in-generic-modifier.md) - [Iterator](../../../visual-basic/language-reference/modifiers/iterator.md) + [Iterator](iterator.md) - [Key](../../../visual-basic/language-reference/modifiers/key.md) + [Key](key.md) - [Module \](../../../visual-basic/language-reference/modifiers/module-keyword.md) + [Module \](module-keyword.md) - [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md) + [MustInherit](mustinherit.md) - [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md) + [MustOverride](mustoverride.md) - [Narrowing](../../../visual-basic/language-reference/modifiers/narrowing.md) + [Narrowing](narrowing.md) - [NotInheritable](../../../visual-basic/language-reference/modifiers/notinheritable.md) + [NotInheritable](notinheritable.md) - [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md) + [NotOverridable](notoverridable.md) - [Optional](../../../visual-basic/language-reference/modifiers/optional.md) + [Optional](optional.md) - [Out](../../../visual-basic/language-reference/modifiers/out-generic-modifier.md) + [Out](out-generic-modifier.md) - [Overloads](../../../visual-basic/language-reference/modifiers/overloads.md) + [Overloads](overloads.md) - [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) + [Overridable](overridable.md) - [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md) + [Overrides](overrides.md) - [ParamArray](../../../visual-basic/language-reference/modifiers/paramarray.md) + [ParamArray](paramarray.md) - [Partial](../../../visual-basic/language-reference/modifiers/partial.md) + [Partial](partial.md) - [Private](../../../visual-basic/language-reference/modifiers/private.md) + [Private](private.md) - [Private Protected](../../../visual-basic/language-reference/modifiers/private-protected.md) + [Private Protected](private-protected.md) - [Protected](../../../visual-basic/language-reference/modifiers/protected.md) + [Protected](protected.md) - [Protected Friend](../../../visual-basic/language-reference/modifiers/protected-friend.md) + [Protected Friend](protected-friend.md) - [Public](../../../visual-basic/language-reference/modifiers/public.md) + [Public](public.md) - [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md) + [ReadOnly](readonly.md) - [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) + [Shadows](shadows.md) - [Shared](../../../visual-basic/language-reference/modifiers/shared.md) + [Shared](shared.md) - [Static](../../../visual-basic/language-reference/modifiers/static.md) + [Static](static.md) - [Unicode](../../../visual-basic/language-reference/modifiers/unicode.md) + [Unicode](unicode.md) - [Widening](../../../visual-basic/language-reference/modifiers/widening.md) + [Widening](widening.md) - [WithEvents](../../../visual-basic/language-reference/modifiers/withevents.md) + [WithEvents](withevents.md) - [WriteOnly](../../../visual-basic/language-reference/modifiers/writeonly.md) + [WriteOnly](writeonly.md) ## Related Sections - [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) + [Visual Basic Language Reference](../index.md) diff --git a/docs/visual-basic/language-reference/modifiers/iterator.md b/docs/visual-basic/language-reference/modifiers/iterator.md index a75d1b4f6e369..4e6a9fc802b5c 100644 --- a/docs/visual-basic/language-reference/modifiers/iterator.md +++ b/docs/visual-basic/language-reference/modifiers/iterator.md @@ -11,11 +11,11 @@ ms.assetid: 69cb0b04-ac87-49d0-bcfe-810c0d60daff Specifies that a function or `Get` accessor is an iterator. ## Remarks - An *iterator* performs a custom iteration over a collection. An iterator uses the [Yield](../../../visual-basic/language-reference/statements/yield-statement.md) statement to return each element in the collection one at a time. When a `Yield` statement is reached, the current location in code is retained. Execution is restarted from that location the next time that the iterator function is called. + An *iterator* performs a custom iteration over a collection. An iterator uses the [Yield](../statements/yield-statement.md) statement to return each element in the collection one at a time. When a `Yield` statement is reached, the current location in code is retained. Execution is restarted from that location the next time that the iterator function is called. An iterator can be implemented as a function or as a `Get` accessor of a property definition. The `Iterator` modifier appears in the declaration of the iterator function or `Get` accessor. - You call an iterator from client code by using a [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md). + You call an iterator from client code by using a [For Each...Next Statement](../statements/for-each-next-statement.md). The return type of an iterator function or `Get` accessor can be , , , or . @@ -28,12 +28,12 @@ Specifies that a function or `Get` accessor is an iterator. ## Usage The `Iterator` modifier can be used in these contexts: -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Statement](../statements/function-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) +- [Property Statement](../statements/property-statement.md) ## Example - The following example demonstrates an iterator function. The iterator function has a `Yield` statement that is inside a [For…Next](../../../visual-basic/language-reference/statements/for-next-statement.md) loop. Each iteration of the [For Each](../../../visual-basic/language-reference/statements/for-each-next-statement.md) statement body in `Main` creates a call to the `Power` iterator function. Each call to the iterator function proceeds to the next execution of the `Yield` statement, which occurs during the next iteration of the `For…Next` loop. + The following example demonstrates an iterator function. The iterator function has a `Yield` statement that is inside a [For…Next](../statements/for-next-statement.md) loop. Each iteration of the [For Each](../statements/for-each-next-statement.md) statement body in `Main` creates a call to the `Power` iterator function. Each call to the iterator function proceeds to the next execution of the `Yield` statement, which occurs during the next iteration of the `For…Next` loop. [!code-vb[VbVbalrStatements#98](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class2.vb#98)] @@ -48,4 +48,4 @@ Specifies that a function or `Get` accessor is an iterator. - - [Iterators](../../programming-guide/concepts/iterators.md) -- [Yield Statement](../../../visual-basic/language-reference/statements/yield-statement.md) +- [Yield Statement](../statements/yield-statement.md) diff --git a/docs/visual-basic/language-reference/modifiers/key.md b/docs/visual-basic/language-reference/modifiers/key.md index b471bf4184269..56d25a372254a 100644 --- a/docs/visual-basic/language-reference/modifiers/key.md +++ b/docs/visual-basic/language-reference/modifiers/key.md @@ -25,7 +25,7 @@ The `Key` keyword enables you to specify behavior for properties of anonymous ty If two instances are declared with only non-key properties, identical in name, type, order, and value, the two instances are not equal. An instance without key properties is equal only to itself. - For more information about the conditions under which two anonymous type instances are instances of the same anonymous type, see [Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/anonymous-types.md). + For more information about the conditions under which two anonymous type instances are instances of the same anonymous type, see [Anonymous Types](../../programming-guide/language-features/objects-and-classes/anonymous-types.md). ## Hash Code Calculation Like , the hash function that is defined in for an anonymous type is based on the key properties of the type. The following examples show the interaction between key properties and hash code values. @@ -49,6 +49,6 @@ The `Key` keyword enables you to specify behavior for properties of anonymous ty ## See also -- [Anonymous Type Definition](../../../visual-basic/programming-guide/language-features/objects-and-classes/anonymous-type-definition.md) -- [How to: Infer Property Names and Types in Anonymous Type Declarations](../../../visual-basic/programming-guide/language-features/objects-and-classes/how-to-infer-property-names-and-types-in-anonymous-type-declarations.md) -- [Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/anonymous-types.md) +- [Anonymous Type Definition](../../programming-guide/language-features/objects-and-classes/anonymous-type-definition.md) +- [How to: Infer Property Names and Types in Anonymous Type Declarations](../../programming-guide/language-features/objects-and-classes/how-to-infer-property-names-and-types-in-anonymous-type-declarations.md) +- [Anonymous Types](../../programming-guide/language-features/objects-and-classes/anonymous-types.md) diff --git a/docs/visual-basic/language-reference/modifiers/module-keyword.md b/docs/visual-basic/language-reference/modifiers/module-keyword.md index 13b0785a3d2f1..875ffa3b7db0c 100644 --- a/docs/visual-basic/language-reference/modifiers/module-keyword.md +++ b/docs/visual-basic/language-reference/modifiers/module-keyword.md @@ -15,12 +15,12 @@ Specifies that an attribute at the beginning of a source file applies to the cur ## Remarks Many attributes pertain to an individual programming element, such as a class or property. You apply such an attribute by attaching the attribute block, within angle brackets (`< >`), directly to the declaration statement. - If an attribute pertains not only to the following element but to the current assembly module, you place the attribute block at the beginning of the source file and identify the attribute with the `Module` keyword. If it applies to the entire assembly, you use the [Assembly](../../../visual-basic/language-reference/modifiers/assembly.md) keyword. + If an attribute pertains not only to the following element but to the current assembly module, you place the attribute block at the beginning of the source file and identify the attribute with the `Module` keyword. If it applies to the entire assembly, you use the [Assembly](assembly.md) keyword. - The `Module` modifier is not the same as the [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md). + The `Module` modifier is not the same as the [Module Statement](../statements/module-statement.md). ## See also -- [Assembly](../../../visual-basic/language-reference/modifiers/assembly.md) -- [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md) -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) +- [Assembly](assembly.md) +- [Module Statement](../statements/module-statement.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/mustinherit.md b/docs/visual-basic/language-reference/modifiers/mustinherit.md index e6cf62a3d2fb0..1e4c977d5eb42 100644 --- a/docs/visual-basic/language-reference/modifiers/mustinherit.md +++ b/docs/visual-basic/language-reference/modifiers/mustinherit.md @@ -39,11 +39,11 @@ Specifies that a class can be used only as a base class and that you cannot crea ## Usage The `MustInherit` modifier can be used in this context: - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](../statements/class-statement.md) ## See also -- [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md) -- [NotInheritable](../../../visual-basic/language-reference/modifiers/notinheritable.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md) +- [Inherits Statement](../statements/inherits-statement.md) +- [NotInheritable](notinheritable.md) +- [Keywords](../keywords/index.md) +- [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md) diff --git a/docs/visual-basic/language-reference/modifiers/mustoverride.md b/docs/visual-basic/language-reference/modifiers/mustoverride.md index 75508081f1a4f..ad088c7d957f1 100644 --- a/docs/visual-basic/language-reference/modifiers/mustoverride.md +++ b/docs/visual-basic/language-reference/modifiers/mustoverride.md @@ -20,7 +20,7 @@ ms.assetid: 6e9d9ad6-bb64-433f-b32b-3ef84293bf96 Specifies that a property or procedure is not implemented in this class and must be overridden in a derived class before it can be used. ## Remarks - You can use `MustOverride` only in a property or procedure declaration statement. The property or procedure that specifies `MustOverride` must be a member of a class, and the class must be marked [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md). + You can use `MustOverride` only in a property or procedure declaration statement. The property or procedure that specifies `MustOverride` must be a member of a class, and the class must be marked [MustInherit](mustinherit.md). ## Rules @@ -28,23 +28,23 @@ Specifies that a property or procedure is not implemented in this class and must - **Combined Modifiers.** You cannot specify `MustOverride` together with `NotOverridable`, `Overridable`, or `Shared` in the same declaration. -- **Shadowing and Overriding.** Both shadowing and overriding redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md). +- **Shadowing and Overriding.** Both shadowing and overriding redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md). - **Alternate Terms.** An element that cannot be used except in an override is sometimes called a *pure virtual* element. The `MustOverride` modifier can be used in these contexts: - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md) -- [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) -- [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md) -- [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md) +- [NotOverridable](notoverridable.md) +- [Overridable](overridable.md) +- [Overrides](overrides.md) +- [MustInherit](mustinherit.md) +- [Keywords](../keywords/index.md) +- [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md) diff --git a/docs/visual-basic/language-reference/modifiers/narrowing.md b/docs/visual-basic/language-reference/modifiers/narrowing.md index b2f253b8913f5..3b5e586b41926 100644 --- a/docs/visual-basic/language-reference/modifiers/narrowing.md +++ b/docs/visual-basic/language-reference/modifiers/narrowing.md @@ -23,13 +23,13 @@ Indicates that a conversion operator (`CType`) converts a class or structure to The `Narrowing` keyword can be used in this context: - [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) + [Operator Statement](../statements/operator-statement.md) ## See also -- [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) -- [Widening](../../../visual-basic/language-reference/modifiers/widening.md) -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) -- [How to: Define an Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-an-operator.md) -- [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) +- [Operator Statement](../statements/operator-statement.md) +- [Widening](widening.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [How to: Define an Operator](../../programming-guide/language-features/procedures/how-to-define-an-operator.md) +- [CType Function](../functions/ctype-function.md) +- [Option Strict Statement](../statements/option-strict-statement.md) diff --git a/docs/visual-basic/language-reference/modifiers/notinheritable.md b/docs/visual-basic/language-reference/modifiers/notinheritable.md index 8204d8e56d5fa..3015199bab06e 100644 --- a/docs/visual-basic/language-reference/modifiers/notinheritable.md +++ b/docs/visual-basic/language-reference/modifiers/notinheritable.md @@ -24,10 +24,10 @@ Specifies that a class cannot be used as a base class. The `NotInheritable` modifier can be used in this context: - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](../statements/class-statement.md) ## See also -- [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md) -- [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Inherits Statement](../statements/inherits-statement.md) +- [MustInherit](mustinherit.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/notoverridable.md b/docs/visual-basic/language-reference/modifiers/notoverridable.md index 600b33ffc2a25..4002b6c7802cb 100644 --- a/docs/visual-basic/language-reference/modifiers/notoverridable.md +++ b/docs/visual-basic/language-reference/modifiers/notoverridable.md @@ -21,7 +21,7 @@ ms.assetid: 66ec6984-f5f5-4857-b362-6a3907aaf9e0 Specifies that a property or procedure cannot be overridden in a derived class. ## Remarks - The `NotOverridable` modifier prevents a property or method from being overridden in a derived class. The [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) modifier allows a property or method in a class to be overridden in a derived class. For more information, see [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md). + The `NotOverridable` modifier prevents a property or method from being overridden in a derived class. The [Overridable](overridable.md) modifier allows a property or method in a class to be overridden in a derived class. For more information, see [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md). If the `Overridable` or `NotOverridable` modifier is not specified, the default setting depends on whether the property or method overrides a base class property or method. If the property or method overrides a base class property or method, the default setting is `Overridable`; otherwise, it is `NotOverridable`. @@ -37,18 +37,18 @@ Specifies that a property or procedure cannot be overridden in a derived class. ## Usage The `NotOverridable` modifier can be used in these contexts: - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [Modifiers](../../../visual-basic/language-reference/modifiers/index.md) -- [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md) -- [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md) -- [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) -- [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md) +- [Modifiers](index.md) +- [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md) +- [MustOverride](mustoverride.md) +- [Overridable](overridable.md) +- [Overrides](overrides.md) +- [Keywords](../keywords/index.md) +- [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md) diff --git a/docs/visual-basic/language-reference/modifiers/optional.md b/docs/visual-basic/language-reference/modifiers/optional.md index ffd1539e27571..6b54ebfefbebd 100644 --- a/docs/visual-basic/language-reference/modifiers/optional.md +++ b/docs/visual-basic/language-reference/modifiers/optional.md @@ -15,25 +15,25 @@ Specifies that a procedure argument can be omitted when the procedure is called. ## Remarks -For each optional parameter, you must specify a constant expression as the default value of that parameter. If the expression evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), the default value of the value data type is used as the default value of the parameter. +For each optional parameter, you must specify a constant expression as the default value of that parameter. If the expression evaluates to [Nothing](../nothing.md), the default value of the value data type is used as the default value of the parameter. If the parameter list contains an optional parameter, every parameter that follows it must also be optional. The `Optional` modifier can be used in these contexts: -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Declare Statement](../statements/declare-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Statement](../statements/function-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) +- [Property Statement](../statements/property-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) +- [Sub Statement](../statements/sub-statement.md) > [!NOTE] -> When calling a procedure with or without optional parameters, you can pass arguments by position or by name. For more information, see [Passing Arguments by Position and by Name](../../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-position-and-by-name.md). +> When calling a procedure with or without optional parameters, you can pass arguments by position or by name. For more information, see [Passing Arguments by Position and by Name](../../programming-guide/language-features/procedures/passing-arguments-by-position-and-by-name.md). > [!NOTE] -> You can also define a procedure with optional parameters by using overloading. If you have one optional parameter, you can define two overloaded versions of the procedure, one that accepts the parameter and one that doesn’t. For more information, see [Procedure Overloading](../../../visual-basic/programming-guide/language-features/procedures/procedure-overloading.md). +> You can also define a procedure with optional parameters by using overloading. If you have one optional parameter, you can define two overloaded versions of the procedure, one that accepts the parameter and one that doesn’t. For more information, see [Procedure Overloading](../../programming-guide/language-features/procedures/procedure-overloading.md). ## Example @@ -66,6 +66,6 @@ The following example demonstrates how to call a procedure with arguments passed ## See also -- [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md) -- [Optional Parameters](../../../visual-basic/programming-guide/language-features/procedures/optional-parameters.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Parameter List](../statements/parameter-list.md) +- [Optional Parameters](../../programming-guide/language-features/procedures/optional-parameters.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/out-generic-modifier.md b/docs/visual-basic/language-reference/modifiers/out-generic-modifier.md index e5b633c26f850..f85e6cbdb8b02 100644 --- a/docs/visual-basic/language-reference/modifiers/out-generic-modifier.md +++ b/docs/visual-basic/language-reference/modifiers/out-generic-modifier.md @@ -59,4 +59,4 @@ The following example shows how to declare, instantiate, and invoke a covariant ## See also - [Variance in Generic Interfaces](../../programming-guide/concepts/covariance-contravariance/variance-in-generic-interfaces.md) -- [In](../../../visual-basic/language-reference/modifiers/in-generic-modifier.md) +- [In](in-generic-modifier.md) diff --git a/docs/visual-basic/language-reference/modifiers/overloads.md b/docs/visual-basic/language-reference/modifiers/overloads.md index 187239ad9cf5d..84f973714b39f 100644 --- a/docs/visual-basic/language-reference/modifiers/overloads.md +++ b/docs/visual-basic/language-reference/modifiers/overloads.md @@ -23,7 +23,7 @@ Specifies that a property or procedure redeclares one or more existing propertie - **Declaration Context.** You can use `Overloads` only in a property or procedure declaration statement. -- **Combined Modifiers.** You cannot specify `Overloads` together with [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) in the same procedure declaration. +- **Combined Modifiers.** You cannot specify `Overloads` together with [Shadows](shadows.md) in the same procedure declaration. - **Required Differences.** The *signature* in this declaration must be different from the signature of every property or procedure that it overloads. The signature comprises the property or procedure name together with the following: @@ -61,18 +61,18 @@ If you use `Overrides`, the compiler implicitly adds `Overloads` so that your li The `Overloads` modifier can be used in these contexts: -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Statement](../statements/function-statement.md) -- [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) +- [Operator Statement](../statements/operator-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) +- [Property Statement](../statements/property-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) +- [Sub Statement](../statements/sub-statement.md) ## See also -- [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) -- [Procedure Overloading](../../../visual-basic/programming-guide/language-features/procedures/procedure-overloading.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md) -- [How to: Define a Conversion Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) +- [Shadows](shadows.md) +- [Procedure Overloading](../../programming-guide/language-features/procedures/procedure-overloading.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md) +- [How to: Define a Conversion Operator](../../programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) diff --git a/docs/visual-basic/language-reference/modifiers/overridable.md b/docs/visual-basic/language-reference/modifiers/overridable.md index a1aed37bc9785..fd0d49c17d1d4 100644 --- a/docs/visual-basic/language-reference/modifiers/overridable.md +++ b/docs/visual-basic/language-reference/modifiers/overridable.md @@ -21,11 +21,11 @@ ms.assetid: 612581e7-8a4c-4a5d-beff-3402fffa6f35 Specifies that a property or procedure can be overridden by an identically named property or procedure in a derived class. ## Remarks - The `Overridable` modifier allows a property or method in a class to be overridden in a derived class. The [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md) modifier prevents a property or method from being overridden in a derived class. For more information, see [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md). + The `Overridable` modifier allows a property or method in a class to be overridden in a derived class. The [NotOverridable](notoverridable.md) modifier prevents a property or method from being overridden in a derived class. For more information, see [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md). If the `Overridable` or `NotOverridable` modifier is not specified, the default setting depends on whether the property or method overrides a base class property or method. If the property or method overrides a base class property or method, the default setting is `Overridable`; otherwise, it is `NotOverridable`. - You can shadow or override to redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md). + You can shadow or override to redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md). An element that can be overridden is sometimes referred to as a *virtual* element. If it can be overridden, but does not have to be, it is sometimes also called a *concrete* element. @@ -41,18 +41,18 @@ Specifies that a property or procedure can be overridden by an identically named ## Usage The `Overridable` modifier can be used in these contexts: - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [Modifiers](../../../visual-basic/language-reference/modifiers/index.md) -- [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md) -- [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md) -- [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md) -- [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md) +- [Modifiers](index.md) +- [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md) +- [MustOverride](mustoverride.md) +- [NotOverridable](notoverridable.md) +- [Overrides](overrides.md) +- [Keywords](../keywords/index.md) +- [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md) diff --git a/docs/visual-basic/language-reference/modifiers/overrides.md b/docs/visual-basic/language-reference/modifiers/overrides.md index 7b11374d6e9d9..3334f3f197ec6 100644 --- a/docs/visual-basic/language-reference/modifiers/overrides.md +++ b/docs/visual-basic/language-reference/modifiers/overrides.md @@ -36,30 +36,30 @@ Specifies that a property or procedure overrides an identically named property o - **Additional Matching.** In addition to matching the signature of the base class version, this declaration must also match it in the following respects: - - Access-level modifier (such as [Public](../../../visual-basic/language-reference/modifiers/public.md)) + - Access-level modifier (such as [Public](public.md)) - - Passing mechanism of each parameter ([ByVal](../../../visual-basic/language-reference/modifiers/byval.md) or [ByRef](../../../visual-basic/language-reference/modifiers/byref.md)) + - Passing mechanism of each parameter ([ByVal](byval.md) or [ByRef](byref.md)) - Constraint lists on each type parameter of a generic procedure -- **Shadowing and Overriding.** Both shadowing and overriding redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md). +- **Shadowing and Overriding.** Both shadowing and overriding redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md). If you use `Overrides`, the compiler implicitly adds `Overloads` so that your library APIs work with C# more easily. The `Overrides` modifier can be used in these contexts: -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Statement](../statements/function-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) +- [Property Statement](../statements/property-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) +- [Sub Statement](../statements/sub-statement.md) ## See also -- [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md) -- [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md) -- [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [Type List](../../../visual-basic/language-reference/statements/type-list.md) +- [MustOverride](mustoverride.md) +- [NotOverridable](notoverridable.md) +- [Overridable](overridable.md) +- [Keywords](../keywords/index.md) +- [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [Type List](../statements/type-list.md) diff --git a/docs/visual-basic/language-reference/modifiers/paramarray.md b/docs/visual-basic/language-reference/modifiers/paramarray.md index 7baa19c70d851..f108223d257e6 100644 --- a/docs/visual-basic/language-reference/modifiers/paramarray.md +++ b/docs/visual-basic/language-reference/modifiers/paramarray.md @@ -13,24 +13,24 @@ ms.assetid: a5f18789-92bd-488f-9c7e-cf3719963635 Specifies that a procedure parameter takes an optional array of elements of the specified type. `ParamArray` can be used only on the last parameter of a parameter list. ## Remarks - `ParamArray` allows you to pass an arbitrary number of arguments to the procedure. A `ParamArray` parameter is always declared using [ByVal](../../../visual-basic/language-reference/modifiers/byval.md). + `ParamArray` allows you to pass an arbitrary number of arguments to the procedure. A `ParamArray` parameter is always declared using [ByVal](byval.md). - You can supply one or more arguments to a `ParamArray` parameter by passing an array of the appropriate data type, a comma-separated list of values, or nothing at all. For details, see "Calling a ParamArray" in [Parameter Arrays](../../../visual-basic/programming-guide/language-features/procedures/parameter-arrays.md). + You can supply one or more arguments to a `ParamArray` parameter by passing an array of the appropriate data type, a comma-separated list of values, or nothing at all. For details, see "Calling a ParamArray" in [Parameter Arrays](../../programming-guide/language-features/procedures/parameter-arrays.md). > [!IMPORTANT] > Whenever you deal with an array which can be indefinitely large, there is a risk of overrunning some internal capacity of your application. If you accept a parameter array from the calling code, you should test its length and take appropriate steps if it is too large for your application. The `ParamArray` modifier can be used in these contexts: - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Parameter Arrays](../../../visual-basic/programming-guide/language-features/procedures/parameter-arrays.md) +- [Keywords](../keywords/index.md) +- [Parameter Arrays](../../programming-guide/language-features/procedures/parameter-arrays.md) diff --git a/docs/visual-basic/language-reference/modifiers/partial.md b/docs/visual-basic/language-reference/modifiers/partial.md index b0cf8d15cd831..f54486dbff197 100644 --- a/docs/visual-basic/language-reference/modifiers/partial.md +++ b/docs/visual-basic/language-reference/modifiers/partial.md @@ -21,7 +21,7 @@ Indicates that a type declaration is a partial definition of the type. You can divide the definition of a type among several declarations by using the `Partial` keyword. You can use as many partial declarations as you want, in as many different source files as you want. However, all the declarations must be in the same assembly and the same namespace. > [!NOTE] -> Visual Basic supports *partial methods*, which are typically implemented in partial classes. For more information, see [Partial Methods](../../../visual-basic/programming-guide/language-features/procedures/partial-methods.md) and [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md). +> Visual Basic supports *partial methods*, which are typically implemented in partial classes. For more information, see [Partial Methods](../../programming-guide/language-features/procedures/partial-methods.md) and [Sub Statement](../statements/sub-statement.md). ## Syntax @@ -39,17 +39,17 @@ Partial { Class | Structure | Interface | Module } name [ (Of typelist) ] |Term|Definition| |---|---| -|`attrlist`|Optional. List of attributes that apply to this type. You must enclose the [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md) in angle brackets (`< >`).| -|`accessmodifier`|Optional. Specifies what code can access this type. See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md).| -|`Shadows`|Optional. See [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md).| -|`MustInherit`|Optional. See [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md).| -|`NotInheritable`|Optional. See [NotInheritable](../../../visual-basic/language-reference/modifiers/notinheritable.md).| +|`attrlist`|Optional. List of attributes that apply to this type. You must enclose the [Attribute List](../statements/attribute-list.md) in angle brackets (`< >`).| +|`accessmodifier`|Optional. Specifies what code can access this type. See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md).| +|`Shadows`|Optional. See [Shadows](shadows.md).| +|`MustInherit`|Optional. See [MustInherit](mustinherit.md).| +|`NotInheritable`|Optional. See [NotInheritable](notinheritable.md).| |`name`|Required. Name of this type. Must match the name defined in all other partial declarations of the same type.| -|`Of`|Optional. Specifies that this is a generic type. See [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md).| -|`typelist`|Required if you use [Of](../../../visual-basic/language-reference/statements/of-clause.md). See [Type List](../../../visual-basic/language-reference/statements/type-list.md).| -|`Inherits`|Optional. See [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md).| +|`Of`|Optional. Specifies that this is a generic type. See [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md).| +|`typelist`|Required if you use [Of](../statements/of-clause.md). See [Type List](../statements/type-list.md).| +|`Inherits`|Optional. See [Inherits Statement](../statements/inherits-statement.md).| |`classname`|Required if you use `Inherits`. The name of the class or interface from which this class derives.| -|`Implements`|Optional. See [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md).| +|`Implements`|Optional. See [Implements Statement](../statements/implements-statement.md).| |`interfacenames`|Required if you use `Implements`. The names of the interfaces this type implements.| |`variabledeclarations`|Optional. Statements which declare additional variables and events for the type.| |`proceduredeclarations`|Optional. Statements which declare and define additional procedures for the type.| @@ -70,15 +70,15 @@ Partial { Class | Structure | Interface | Module } name [ (Of typelist) ] - **Union of Declarations.** The compiler treats the type as the union of all its partial declarations. Every modifier from every partial definition applies to the entire type, and every member from every partial definition is available to the entire type. -- **Type Promotion Not Allowed For Partial Types in Modules.** If a partial definition is inside a module, type promotion of that type is automatically defeated. In such a case, a set of partial definitions can cause unexpected results and even compiler errors. For more information, see [Type Promotion](../../../visual-basic/programming-guide/language-features/declared-elements/type-promotion.md). +- **Type Promotion Not Allowed For Partial Types in Modules.** If a partial definition is inside a module, type promotion of that type is automatically defeated. In such a case, a set of partial definitions can cause unexpected results and even compiler errors. For more information, see [Type Promotion](../../programming-guide/language-features/declared-elements/type-promotion.md). The compiler merges partial definitions only when their fully qualified paths are identical. The `Partial` keyword can be used in these contexts: - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](../statements/class-statement.md) - [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) + [Structure Statement](../statements/structure-statement.md) ## Example The following example splits the definition of class `sampleClass` into two declarations, each of which defines a different `Sub` procedure. @@ -89,9 +89,9 @@ Partial { Class | Structure | Interface | Module } name [ (Of typelist) ] ## See also -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) -- [Type Promotion](../../../visual-basic/programming-guide/language-features/declared-elements/type-promotion.md) -- [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [Partial Methods](../../../visual-basic/programming-guide/language-features/procedures/partial-methods.md) +- [Class Statement](../statements/class-statement.md) +- [Structure Statement](../statements/structure-statement.md) +- [Type Promotion](../../programming-guide/language-features/declared-elements/type-promotion.md) +- [Shadows](shadows.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [Partial Methods](../../programming-guide/language-features/procedures/partial-methods.md) diff --git a/docs/visual-basic/language-reference/modifiers/private-protected.md b/docs/visual-basic/language-reference/modifiers/private-protected.md index fd9337b896f8d..f8ebe440efdaf 100644 --- a/docs/visual-basic/language-reference/modifiers/private-protected.md +++ b/docs/visual-basic/language-reference/modifiers/private-protected.md @@ -20,7 +20,7 @@ The `Private Protected` access modifier is supported by Visual Basic 15.5 and la ``` -For more information see [setting the Visual Basic language version](../../language-reference/configure-language-version.md). +For more information see [setting the Visual Basic language version](../configure-language-version.md). > [!NOTE] > In Visual Studio, selecting F1 help on `private protected` provides help for either [private](private.md) or [protected](protected.md). The IDE picks the single token under the cursor rather than the compound word. @@ -33,42 +33,42 @@ For more information see [setting the Visual Basic language version](../../langu - **Access Level.** All code in a class can access its elements. Code in any class that derives from a base class and is contained in the same assembly can access all the `Private Protected` elements of the base class. However, code in any class that derives from a base class and is contained in a different assembly can't access the base class `Private Protected` elements. -- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). The `Private Protected` modifier can be used in these contexts: -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) of a nested class +- [Class Statement](../statements/class-statement.md) of a nested class -- [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) +- [Const Statement](../statements/const-statement.md) -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Declare Statement](../statements/declare-statement.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) of a delegate nested in a class +- [Delegate Statement](../statements/delegate-statement.md) of a delegate nested in a class -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) +- [Dim Statement](../statements/dim-statement.md) -- [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) of an enumeration nested in a class +- [Enum Statement](../statements/enum-statement.md) of an enumeration nested in a class -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) +- [Event Statement](../statements/event-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Statement](../statements/function-statement.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) of an interface nested in a class +- [Interface Statement](../statements/interface-statement.md) of an interface nested in a class -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) +- [Property Statement](../statements/property-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) of a structure nested in a class +- [Structure Statement](../statements/structure-statement.md) of a structure nested in a class -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) +- [Sub Statement](../statements/sub-statement.md) ## See also -- [Public](../../../visual-basic/language-reference/modifiers/public.md) -- [Protected](../../../visual-basic/language-reference/modifiers/protected.md) +- [Public](public.md) +- [Protected](protected.md) - [Friend](friend.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) +- [Private](private.md) - [Protected Friend](./protected-friend.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/private.md b/docs/visual-basic/language-reference/modifiers/private.md index bdfe9ca0881d8..aae5b75ca9616 100644 --- a/docs/visual-basic/language-reference/modifiers/private.md +++ b/docs/visual-basic/language-reference/modifiers/private.md @@ -25,42 +25,42 @@ Specifies that one or more declared programming elements are accessible only fro - **Access Level.** All code within a declaration context can access its `Private` elements. This includes code within a contained type, such as a nested class or an assignment expression in an enumeration. No code outside of the declaration context can access its `Private` elements. -- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). The `Private` modifier can be used in these contexts: - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](../statements/class-statement.md) - [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) + [Const Statement](../statements/const-statement.md) - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) - [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) + [Delegate Statement](../statements/delegate-statement.md) - [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) + [Dim Statement](../statements/dim-statement.md) - [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) + [Enum Statement](../statements/enum-statement.md) - [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) + [Event Statement](../statements/event-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) + [Interface Statement](../statements/interface-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) + [Structure Statement](../statements/structure-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [Public](../../../visual-basic/language-reference/modifiers/public.md) -- [Protected](../../../visual-basic/language-reference/modifiers/protected.md) -- [Friend](../../../visual-basic/language-reference/modifiers/friend.md) +- [Public](public.md) +- [Protected](protected.md) +- [Friend](friend.md) - [Private Protected](./private-protected.md) - [Protected Friend](./protected-friend.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/protected-friend.md b/docs/visual-basic/language-reference/modifiers/protected-friend.md index a39b1311bf550..c9457acae1acb 100644 --- a/docs/visual-basic/language-reference/modifiers/protected-friend.md +++ b/docs/visual-basic/language-reference/modifiers/protected-friend.md @@ -18,12 +18,12 @@ The `Protected Friend` keyword combination is a member access modifier. It confe ## See also -- [Public](../../../visual-basic/language-reference/modifiers/public.md) -- [Protected](../../../visual-basic/language-reference/modifiers/protected.md) +- [Public](public.md) +- [Protected](protected.md) - [Friend](friend.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) +- [Private](private.md) - [Private Protected](./private-protected.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/protected.md b/docs/visual-basic/language-reference/modifiers/protected.md index e0710aca586fc..10c7777baf440 100644 --- a/docs/visual-basic/language-reference/modifiers/protected.md +++ b/docs/visual-basic/language-reference/modifiers/protected.md @@ -35,42 +35,42 @@ Sometimes a programming element declared in a class contains sensitive data or r Protected access is not a superset or subset of friend access. -- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). The `Protected` modifier can be used in these contexts: -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) +- [Class Statement](../statements/class-statement.md) -- [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) +- [Const Statement](../statements/const-statement.md) -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Declare Statement](../statements/declare-statement.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) +- [Delegate Statement](../statements/delegate-statement.md) -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) +- [Dim Statement](../statements/dim-statement.md) -- [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) +- [Enum Statement](../statements/enum-statement.md) -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) +- [Event Statement](../statements/event-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Statement](../statements/function-statement.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) +- [Interface Statement](../statements/interface-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) +- [Property Statement](../statements/property-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) +- [Structure Statement](../statements/structure-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) +- [Sub Statement](../statements/sub-statement.md) ## See also -- [Public](../../../visual-basic/language-reference/modifiers/public.md) -- [Friend](../../../visual-basic/language-reference/modifiers/friend.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) +- [Public](public.md) +- [Friend](friend.md) +- [Private](private.md) - [Private Protected](private-protected.md) - [Protected Friend](protected-friend.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/public.md b/docs/visual-basic/language-reference/modifiers/public.md index f9b719a2e7a09..5c706e9663010 100644 --- a/docs/visual-basic/language-reference/modifiers/public.md +++ b/docs/visual-basic/language-reference/modifiers/public.md @@ -27,46 +27,46 @@ Specifies that one or more declared programming elements have no access restrict - **Default Access.** Local variables inside a procedure default to public access, and you cannot use any access modifiers on them. -- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +- **Access Modifiers.** The keywords that specify access level are called *access modifiers*. For a comparison of the access modifiers, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). The `Public` modifier can be used in these contexts: - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](../statements/class-statement.md) - [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) + [Const Statement](../statements/const-statement.md) - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) - [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) + [Delegate Statement](../statements/delegate-statement.md) - [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) + [Dim Statement](../statements/dim-statement.md) - [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) + [Enum Statement](../statements/enum-statement.md) - [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) + [Event Statement](../statements/event-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) + [Interface Statement](../statements/interface-statement.md) - [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md) + [Module Statement](../statements/module-statement.md) - [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) + [Operator Statement](../statements/operator-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) + [Structure Statement](../statements/structure-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [Protected](../../../visual-basic/language-reference/modifiers/protected.md) -- [Friend](../../../visual-basic/language-reference/modifiers/friend.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) +- [Protected](protected.md) +- [Friend](friend.md) +- [Private](private.md) - [Private Protected](private-protected.md) - [Protected Friend](protected-friend.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/readonly.md b/docs/visual-basic/language-reference/modifiers/readonly.md index 5072cf1b92e00..f2899528cca42 100644 --- a/docs/visual-basic/language-reference/modifiers/readonly.md +++ b/docs/visual-basic/language-reference/modifiers/readonly.md @@ -28,7 +28,7 @@ Specifies that a variable or property can be read but not written. ## When to Use a ReadOnly Variable -There are situations in which you cannot use a [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) to declare and assign a constant value. For example, the `Const` statement might not accept the data type you want to assign, or you might not be able to compute the value at compile time with a constant expression. You might not even know the value at compile time. In these cases, you can use a `ReadOnly` variable to hold a constant value. +There are situations in which you cannot use a [Const Statement](../statements/const-statement.md) to declare and assign a constant value. For example, the `Const` statement might not accept the data type you want to assign, or you might not be able to compute the value at compile time with a constant expression. You might not even know the value at compile time. In these cases, you can use a `ReadOnly` variable to hold a constant value. > [!IMPORTANT] > If the data type of the variable is a reference type, such as an array or a class instance, its members can be changed even if the variable itself is `ReadOnly`. The following example illustrates this. diff --git a/docs/visual-basic/language-reference/modifiers/shadows.md b/docs/visual-basic/language-reference/modifiers/shadows.md index a230c3fd176fc..1474b7461cfc4 100644 --- a/docs/visual-basic/language-reference/modifiers/shadows.md +++ b/docs/visual-basic/language-reference/modifiers/shadows.md @@ -20,7 +20,7 @@ Specifies that a declared programming element redeclares and hides an identicall The main purpose of shadowing (which is also known as *hiding by name*) is to preserve the definition of your class members. The base class might undergo a change that creates an element with the same name as one you have already defined. If this happens, the `Shadows` modifier forces references through your class to be resolved to the member you defined, instead of to the new base class element. -Both shadowing and overriding redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md). +Both shadowing and overriding redefine an inherited element, but there are significant differences between the two approaches. For more information, see [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md). ## Rules @@ -40,40 +40,40 @@ Both shadowing and overriding redefine an inherited element, but there are signi The `Shadows` modifier can be used in these contexts: -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) +- [Class Statement](../statements/class-statement.md) -- [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) +- [Const Statement](../statements/const-statement.md) -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) +- [Declare Statement](../statements/declare-statement.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) +- [Delegate Statement](../statements/delegate-statement.md) -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) +- [Dim Statement](../statements/dim-statement.md) -- [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) +- [Enum Statement](../statements/enum-statement.md) -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) +- [Event Statement](../statements/event-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) +- [Function Statement](../statements/function-statement.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) +- [Interface Statement](../statements/interface-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) +- [Property Statement](../statements/property-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) +- [Structure Statement](../statements/structure-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) +- [Sub Statement](../statements/sub-statement.md) ## See also -- [Shared](../../../visual-basic/language-reference/modifiers/shared.md) -- [Static](../../../visual-basic/language-reference/modifiers/static.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) -- [Me, My, MyBase, and MyClass](../../../visual-basic/programming-guide/program-structure/me-my-mybase-and-myclass.md) -- [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md) -- [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md) -- [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md) -- [Overloads](../../../visual-basic/language-reference/modifiers/overloads.md) -- [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) -- [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md) -- [Shadowing in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/shadowing.md) +- [Shared](shared.md) +- [Static](static.md) +- [Private](private.md) +- [Me, My, MyBase, and MyClass](../../programming-guide/program-structure/me-my-mybase-and-myclass.md) +- [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md) +- [MustOverride](mustoverride.md) +- [NotOverridable](notoverridable.md) +- [Overloads](overloads.md) +- [Overridable](overridable.md) +- [Overrides](overrides.md) +- [Shadowing in Visual Basic](../../programming-guide/language-features/declared-elements/shadowing.md) diff --git a/docs/visual-basic/language-reference/modifiers/shared.md b/docs/visual-basic/language-reference/modifiers/shared.md index 33e12d22de7b6..dccfbb1d5dce4 100644 --- a/docs/visual-basic/language-reference/modifiers/shared.md +++ b/docs/visual-basic/language-reference/modifiers/shared.md @@ -20,13 +20,13 @@ Specifies that one or more declared programming elements are associated with a c ## When to Use Shared Sharing a member of a class or structure makes it available to every instance, rather than *nonshared*, where each instance keeps its own copy. This is useful, for example, if the value of a variable applies to the entire application. If you declare that variable to be `Shared`, then all instances access the same storage location, and if one instance changes the variable's value, all instances access the updated value. - Sharing does not alter the access level of a member. For example, a class member can be shared and private (accessible only from within the class), or nonshared and public. For more information, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). + Sharing does not alter the access level of a member. For example, a class member can be shared and private (accessible only from within the class), or nonshared and public. For more information, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). ## Rules - **Declaration Context.** You can use `Shared` only at module level. This means the declaration context for a `Shared` element must be a class or structure, and cannot be a source file, namespace, or procedure. -- **Combined Modifiers.** You cannot specify `Shared` together with [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md), [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md), [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md), [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md), or [Static](../../../visual-basic/language-reference/modifiers/static.md) in the same declaration. +- **Combined Modifiers.** You cannot specify `Shared` together with [Overrides](overrides.md), [Overridable](overridable.md), [NotOverridable](notoverridable.md), [MustOverride](mustoverride.md), or [Static](static.md) in the same declaration. - **Accessing.** You access a shared element by qualifying it with its class or structure name, not with the variable name of a specific instance of its class or structure. You do not even have to create an instance of a class or structure to access its shared members. @@ -34,7 +34,7 @@ Specifies that one or more declared programming elements are associated with a c `If Double.IsNaN(result) Then MsgBox("Result is mathematically undefined.")` -- **Implicit Sharing.** You cannot use the `Shared` modifier in a [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md), but constants are implicitly shared. Similarly, you cannot declare a member of a module or an interface to be `Shared`, but they are implicitly shared. +- **Implicit Sharing.** You cannot use the `Shared` modifier in a [Const Statement](../statements/const-statement.md), but constants are implicitly shared. Similarly, you cannot declare a member of a module or an interface to be `Shared`, but they are implicitly shared. ## Behavior @@ -74,23 +74,23 @@ Specifies that one or more declared programming elements are associated with a c The `Shared` modifier can be used in these contexts: - [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) + [Dim Statement](../statements/dim-statement.md) - [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) + [Event Statement](../statements/event-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](../statements/function-statement.md) - [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) + [Operator Statement](../statements/operator-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](../statements/sub-statement.md) ## See also -- [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) -- [Static](../../../visual-basic/language-reference/modifiers/static.md) -- [Lifetime in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/lifetime.md) -- [Procedures](../../../visual-basic/programming-guide/language-features/procedures/index.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Shadows](shadows.md) +- [Static](static.md) +- [Lifetime in Visual Basic](../../programming-guide/language-features/declared-elements/lifetime.md) +- [Procedures](../../programming-guide/language-features/procedures/index.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/static.md b/docs/visual-basic/language-reference/modifiers/static.md index 263cb7307600f..654ff189ed435 100644 --- a/docs/visual-basic/language-reference/modifiers/static.md +++ b/docs/visual-basic/language-reference/modifiers/static.md @@ -20,7 +20,7 @@ Specifies that one or more declared local variables are to continue to exist and You cannot use `Static` inside a structure procedure. -- The data types of `Static` local variables cannot be inferred. For more information, see [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md). +- The data types of `Static` local variables cannot be inferred. For more information, see [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md). - **Combined Modifiers.** You cannot specify `Static` together with `ReadOnly`, `Shadows`, or `Shared` in the same declaration. @@ -38,14 +38,14 @@ Specifies that one or more declared local variables are to continue to exist and The `Static` modifier can be used in this context: - [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) + [Dim Statement](../statements/dim-statement.md) ## See also -- [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) -- [Shared](../../../visual-basic/language-reference/modifiers/shared.md) -- [Lifetime in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/lifetime.md) -- [Variable Declaration](../../../visual-basic/programming-guide/language-features/variables/variable-declaration.md) -- [Structures](../../../visual-basic/programming-guide/language-features/data-types/structures.md) -- [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) +- [Shadows](shadows.md) +- [Shared](shared.md) +- [Lifetime in Visual Basic](../../programming-guide/language-features/declared-elements/lifetime.md) +- [Variable Declaration](../../programming-guide/language-features/variables/variable-declaration.md) +- [Structures](../../programming-guide/language-features/data-types/structures.md) +- [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/unicode.md b/docs/visual-basic/language-reference/modifiers/unicode.md index cce415f339b2e..f458a4e282049 100644 --- a/docs/visual-basic/language-reference/modifiers/unicode.md +++ b/docs/visual-basic/language-reference/modifiers/unicode.md @@ -13,7 +13,7 @@ ms.assetid: 0021d5ff-3209-444e-8497-420f3e6ee075 # Unicode (Visual Basic) Specifies that Visual Basic should marshal all strings to Unicode values regardless of the name of the external procedure being declared. - When you call a procedure defined outside your project, the Visual Basic compiler does not have access to the information it must have in order to call the procedure correctly. This information includes where the procedure is located, how it is identified, its calling sequence and return type, and the string character set it uses. The [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) creates a reference to an external procedure and supplies this necessary information. + When you call a procedure defined outside your project, the Visual Basic compiler does not have access to the information it must have in order to call the procedure correctly. This information includes where the procedure is located, how it is identified, its calling sequence and return type, and the string character set it uses. The [Declare Statement](../statements/declare-statement.md) creates a reference to an external procedure and supplies this necessary information. The `charsetmodifier` part in the `Declare` statement supplies the character set information to marshal strings during a call to the external procedure. It also affects how Visual Basic searches the external file for the external procedure name. The `Unicode` modifier specifies that Visual Basic should marshal all strings to Unicode values and should look up the procedure without modifying its name during the search. @@ -22,13 +22,13 @@ Specifies that Visual Basic should marshal all strings to Unicode values regardl ## Remarks The `Unicode` modifier can be used in this context: - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](../statements/declare-statement.md) ## Smart Device Developer Notes This keyword is not supported. ## See also -- [Ansi](../../../visual-basic/language-reference/modifiers/ansi.md) -- [Auto](../../../visual-basic/language-reference/modifiers/auto.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Ansi](ansi.md) +- [Auto](auto.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/widening.md b/docs/visual-basic/language-reference/modifiers/widening.md index 83112d710a0e3..f1dd100377b81 100644 --- a/docs/visual-basic/language-reference/modifiers/widening.md +++ b/docs/visual-basic/language-reference/modifiers/widening.md @@ -23,16 +23,16 @@ Indicates that a conversion operator (`CType`) converts a class or structure to The `Widening` keyword can be used in this context: - [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) + [Operator Statement](../statements/operator-statement.md) - For example definitions of widening and narrowing conversion operators, see [How to: Define a Conversion Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md). + For example definitions of widening and narrowing conversion operators, see [How to: Define a Conversion Operator](../../programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md). ## See also -- [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) -- [Narrowing](../../../visual-basic/language-reference/modifiers/narrowing.md) -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) -- [How to: Define an Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-an-operator.md) -- [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) -- [How to: Define a Conversion Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) +- [Operator Statement](../statements/operator-statement.md) +- [Narrowing](narrowing.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [How to: Define an Operator](../../programming-guide/language-features/procedures/how-to-define-an-operator.md) +- [CType Function](../functions/ctype-function.md) +- [Option Strict Statement](../statements/option-strict-statement.md) +- [How to: Define a Conversion Operator](../../programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) diff --git a/docs/visual-basic/language-reference/modifiers/withevents.md b/docs/visual-basic/language-reference/modifiers/withevents.md index ec2e0e8d61be7..595c571902576 100644 --- a/docs/visual-basic/language-reference/modifiers/withevents.md +++ b/docs/visual-basic/language-reference/modifiers/withevents.md @@ -25,7 +25,7 @@ You can declare only individual variables—not arrays—with `WithEvents`. **Element Types.** You must declare `WithEvents` variables to be object variables so that they can accept class instances. However, you cannot declare them as `Object`. You must declare them as the specific class that can raise the events. -The `WithEvents` modifier can be used in this context: [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) +The `WithEvents` modifier can be used in this context: [Dim Statement](../statements/dim-statement.md) ## Example @@ -35,6 +35,6 @@ Dim WithEvents app As Application ## See also -- [Handles](../../../visual-basic/language-reference/statements/handles-clause.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [Handles](../statements/handles-clause.md) +- [Keywords](../keywords/index.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/modifiers/writeonly.md b/docs/visual-basic/language-reference/modifiers/writeonly.md index 2b3ff36ec0c32..776264b6890d8 100644 --- a/docs/visual-basic/language-reference/modifiers/writeonly.md +++ b/docs/visual-basic/language-reference/modifiers/writeonly.md @@ -28,9 +28,9 @@ Specifies that a property can be written but not read. > [!IMPORTANT] > When you define and use a `WriteOnly` property, consider the following additional protective measures: -- **Overriding.** If the property is a member of a class, allow it to default to [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md), and do not declare it `Overridable` or `MustOverride`. This prevents a derived class from making undesired access through an override. +- **Overriding.** If the property is a member of a class, allow it to default to [NotOverridable](notoverridable.md), and do not declare it `Overridable` or `MustOverride`. This prevents a derived class from making undesired access through an override. -- **Access Level.** If you hold the property's sensitive data in one or more variables, declare them [Private](../../../visual-basic/language-reference/modifiers/private.md) so that no other code can access them. +- **Access Level.** If you hold the property's sensitive data in one or more variables, declare them [Private](private.md) so that no other code can access them. - **Encryption.** Store all sensitive data in encrypted form rather than in plain text. If malicious code somehow gains access to that area of memory, it is more difficult to make use of the data. Encryption is also useful if it is necessary to serialize the sensitive data. @@ -40,10 +40,10 @@ Specifies that a property can be written but not read. The `WriteOnly` modifier can be used in this context: - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](../statements/property-statement.md) ## See also -- [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [ReadOnly](readonly.md) +- [Private](private.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/modules.md b/docs/visual-basic/language-reference/modules.md index 2946c53dacebb..a3b31131a9a6a 100644 --- a/docs/visual-basic/language-reference/modules.md +++ b/docs/visual-basic/language-reference/modules.md @@ -26,4 +26,4 @@ Visual Basic provides several modules that enable you to simplify common tasks i ## See also -- [Visual Basic Language Reference](../../visual-basic/language-reference/index.md) +- [Visual Basic Language Reference](index.md) diff --git a/docs/visual-basic/language-reference/objects/index.md b/docs/visual-basic/language-reference/objects/index.md index f8361da8171c0..58ef48b74dffb 100644 --- a/docs/visual-basic/language-reference/objects/index.md +++ b/docs/visual-basic/language-reference/objects/index.md @@ -29,16 +29,16 @@ This topic provides links to other topics that document the Visual Basic run-tim |`My.Computer.Network` ()|Provides a property, an event, and methods for interacting with the network to which the computer is connected.| |`My.Computer.Ports` ()|Provides a property and a method for accessing the computer's serial ports.| |`My.Computer.Registry` ()|Provides properties and methods for manipulating the registry.| -|[My.Forms Object](../../../visual-basic/language-reference/objects/my-forms-object.md)|Provides properties for accessing an instance of each Windows Form declared in the current project.| +|[My.Forms Object](my-forms-object.md)|Provides properties for accessing an instance of each Windows Form declared in the current project.| |`My.Log` ()|Provides a property and methods for writing event and exception information to the application's log listeners for Web applications.| -|[My.Request Object](../../../visual-basic/language-reference/objects/my-request-object.md)|Gets the object for the requested page. The `My.Request` object contains information about the current HTTP request.

The `My.Request` object is available only for ASP.NET applications.| -|[My.Resources Object](../../../visual-basic/language-reference/objects/my-resources-object.md)|Provides properties and classes for accessing an application's resources.| -|[My.Response Object](../../../visual-basic/language-reference/objects/my-response-object.md)|Gets the object that is associated with the . This object allows you to send HTTP response data to a client and contains information about that response.

The `My.Response` object is available only for ASP.NET applications.| -|[My.Settings Object](../../../visual-basic/language-reference/objects/my-settings-object.md)|Provides properties and methods for accessing an application's settings.| +|[My.Request Object](my-request-object.md)|Gets the object for the requested page. The `My.Request` object contains information about the current HTTP request.

The `My.Request` object is available only for ASP.NET applications.| +|[My.Resources Object](my-resources-object.md)|Provides properties and classes for accessing an application's resources.| +|[My.Response Object](my-response-object.md)|Gets the object that is associated with the . This object allows you to send HTTP response data to a client and contains information about that response.

The `My.Response` object is available only for ASP.NET applications.| +|[My.Settings Object](my-settings-object.md)|Provides properties and methods for accessing an application's settings.| |`My.User` ()|Provides access to information about the current user.| -|[My.WebServices Object](../../../visual-basic/language-reference/objects/my-webservices-object.md)|Provides properties for creating and accessing a single instance of each Web service that is referenced by the current project.| +|[My.WebServices Object](my-webservices-object.md)|Provides properties for creating and accessing a single instance of each Web service that is referenced by the current project.| ||Provides methods and properties for parsing structured text files.| ## See also -- [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) +- [Visual Basic Language Reference](../index.md) diff --git a/docs/visual-basic/language-reference/objects/my-application-info-object.md b/docs/visual-basic/language-reference/objects/my-application-info-object.md index 651c5e9a4606e..2206b5fd6a5fa 100644 --- a/docs/visual-basic/language-reference/objects/my-application-info-object.md +++ b/docs/visual-basic/language-reference/objects/my-application-info-object.md @@ -24,4 +24,4 @@ Provides properties for getting the information about the application, such as t ## See also -- [My.Application Object](../../../visual-basic/language-reference/objects/my-application-object.md) +- [My.Application Object](my-application-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-application-log-object.md b/docs/visual-basic/language-reference/objects/my-application-log-object.md index 45954fe0eeef8..c140102611bdf 100644 --- a/docs/visual-basic/language-reference/objects/my-application-log-object.md +++ b/docs/visual-basic/language-reference/objects/my-application-log-object.md @@ -11,7 +11,7 @@ Provides a property and methods to write event and exception information to the ## Remarks For information about the methods and properties of the `My.Application.Log` object, see . - For more information, see [Logging Information from the Application](../../../visual-basic/developing-apps/programming/log-info/index.md). + For more information, see [Logging Information from the Application](../../developing-apps/programming/log-info/index.md). > [!NOTE] > You can also use classes in the .NET Framework to log information from your application. For more information, see [Tracing and Instrumenting Applications](../../../framework/debug-trace-profile/tracing-and-instrumenting-applications.md). @@ -25,4 +25,4 @@ Provides a property and methods to write event and exception information to the ## See also -- [My.Application Object](../../../visual-basic/language-reference/objects/my-application-object.md) +- [My.Application Object](my-application-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-application-object.md b/docs/visual-basic/language-reference/objects/my-application-object.md index d72ca07867d6a..31f4344224e98 100644 --- a/docs/visual-basic/language-reference/objects/my-application-object.md +++ b/docs/visual-basic/language-reference/objects/my-application-object.md @@ -26,5 +26,5 @@ Provides properties, methods, and events related to the current application. ## See also -- [My.Application.Info Object](../../../visual-basic/language-reference/objects/my-application-info-object.md) -- [My.Application.Log Object](../../../visual-basic/language-reference/objects/my-application-log-object.md) +- [My.Application.Info Object](my-application-info-object.md) +- [My.Application.Log Object](my-application-log-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-audio-object.md b/docs/visual-basic/language-reference/objects/my-computer-audio-object.md index a8a407a36eda0..fd20780a0cc67 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-audio-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-audio-object.md @@ -12,7 +12,7 @@ Provides methods for playing sounds. ## Remarks For information about the methods and properties of the `My.Computer.Audio` object, see . - For more information, see [Playing Sounds](../../../visual-basic/developing-apps/programming/computer-resources/playing-sounds.md). + For more information, see [Playing Sounds](../../developing-apps/programming/computer-resources/playing-sounds.md). ## Requirements **Namespace:** @@ -23,4 +23,4 @@ Provides methods for playing sounds. ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-clipboard-object.md b/docs/visual-basic/language-reference/objects/my-computer-clipboard-object.md index fe6a2125bf32d..af209eb337b73 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-clipboard-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-clipboard-object.md @@ -12,7 +12,7 @@ Provides methods for manipulating the Clipboard. ## Remarks For information about the methods and properties of the `My.Computer.Clipboard` object, see . - For more information, see [Storing Data to and Reading from the Clipboard](../../../visual-basic/developing-apps/programming/computer-resources/storing-data-to-and-reading-from-the-clipboard.md). + For more information, see [Storing Data to and Reading from the Clipboard](../../developing-apps/programming/computer-resources/storing-data-to-and-reading-from-the-clipboard.md). > [!NOTE] > You can also use methods of the class to manipulate the Clipboard. @@ -27,4 +27,4 @@ Provides methods for manipulating the Clipboard. ## See also - -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-clock-object.md b/docs/visual-basic/language-reference/objects/my-computer-clock-object.md index a408cbd80196f..b9fc4f1c08bd9 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-clock-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-clock-object.md @@ -20,4 +20,4 @@ Provides properties for accessing the current local time and Universal Coordinat ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-filesystem-object.md b/docs/visual-basic/language-reference/objects/my-computer-filesystem-object.md index 1b5e7836910ca..03d00e022cb83 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-filesystem-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-filesystem-object.md @@ -19,7 +19,7 @@ Provides properties and methods for working with drives, files, and directories. ## Remarks For information about the methods and properties of the `My.Computer.FileSystem` object, see . - For more information, see [File Access with Visual Basic](../../../visual-basic/developing-apps/programming/drives-directories-files/file-access.md). + For more information, see [File Access with Visual Basic](../../developing-apps/programming/drives-directories-files/file-access.md). > [!NOTE] > You can also use classes in the namespace to work with drives, files, and directories. @@ -33,5 +33,5 @@ Provides properties and methods for working with drives, files, and directories. ## See also -- [My.Computer.FileSystem.SpecialDirectories Object](../../../visual-basic/language-reference/objects/my-computer-filesystem-specialdirectories-object.md) -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer.FileSystem.SpecialDirectories Object](my-computer-filesystem-specialdirectories-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-filesystem-specialdirectories-object.md b/docs/visual-basic/language-reference/objects/my-computer-filesystem-specialdirectories-object.md index 30af78dfc930e..6b75e3cebebc8 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-filesystem-specialdirectories-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-filesystem-specialdirectories-object.md @@ -12,7 +12,7 @@ Provides properties for accessing commonly referenced directories. ## Remarks For information about the methods and properties of the `My.Computer.FileSystem.SpecialDirectories` object, see . - For more information, see [How to: Retrieve the Contents of the My Documents Directory](../../../visual-basic/developing-apps/programming/drives-directories-files/how-to-retrieve-the-contents-of-the-my-documents-directory.md). + For more information, see [How to: Retrieve the Contents of the My Documents Directory](../../developing-apps/programming/drives-directories-files/how-to-retrieve-the-contents-of-the-my-documents-directory.md). ## Requirements **Namespace:** @@ -23,5 +23,5 @@ Provides properties for accessing commonly referenced directories. ## See also -- [My.Computer.FileSystem Object](../../../visual-basic/language-reference/objects/my-computer-filesystem-object.md) -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer.FileSystem Object](my-computer-filesystem-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-info-object.md b/docs/visual-basic/language-reference/objects/my-computer-info-object.md index 20f90214e15d9..aa7d34d7f6102 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-info-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-info-object.md @@ -20,4 +20,4 @@ Provides properties for getting information about the computer's memory, loaded ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-keyboard-object.md b/docs/visual-basic/language-reference/objects/my-computer-keyboard-object.md index 18a1f46220bb3..e3b53ad891459 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-keyboard-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-keyboard-object.md @@ -11,7 +11,7 @@ Provides properties for accessing the current state of the keyboard, such as wha ## Remarks For information about the methods and properties of the `My.Computer.Keyword` object, see . - For more information, see [Accessing the Keyboard](../../../visual-basic/developing-apps/programming/computer-resources/accessing-the-keyboard.md). + For more information, see [Accessing the Keyboard](../../developing-apps/programming/computer-resources/accessing-the-keyboard.md). ## Requirements **Namespace:** @@ -22,4 +22,4 @@ Provides properties for accessing the current state of the keyboard, such as wha ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-mouse-object.md b/docs/visual-basic/language-reference/objects/my-computer-mouse-object.md index 039ed668abaa4..00bfdbeb7bb0b 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-mouse-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-mouse-object.md @@ -11,7 +11,7 @@ Provides properties for getting information about the format and configuration o ## Remarks For information about the methods and properties of the `My.Computer.Mouse` object, see . - For more information, see [Accessing the Mouse](../../../visual-basic/developing-apps/programming/computer-resources/accessing-the-mouse.md). + For more information, see [Accessing the Mouse](../../developing-apps/programming/computer-resources/accessing-the-mouse.md). ## Requirements **Namespace:** @@ -22,4 +22,4 @@ Provides properties for getting information about the format and configuration o ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-network-object.md b/docs/visual-basic/language-reference/objects/my-computer-network-object.md index f020e0809f998..25dcb6e7837e5 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-network-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-network-object.md @@ -11,7 +11,7 @@ Provides a property, event, and methods for interacting with the network to whic ## Remarks For information about the methods and properties of the `My.Computer.Network` object, see . - For more information, see [Performing Network Operations](../../../visual-basic/developing-apps/programming/computer-resources/performing-network-operations.md). + For more information, see [Performing Network Operations](../../developing-apps/programming/computer-resources/performing-network-operations.md). ## Requirements **Namespace:** @@ -22,4 +22,4 @@ Provides a property, event, and methods for interacting with the network to whic ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-object.md b/docs/visual-basic/language-reference/objects/my-computer-object.md index bc703230bc6f8..4f04a7197c9a0 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-object.md @@ -20,14 +20,14 @@ Provides properties for manipulating computer components such as audio, the cloc ## See also -- [My.Computer.Audio Object](../../../visual-basic/language-reference/objects/my-computer-audio-object.md) -- [My.Computer.Clipboard Object](../../../visual-basic/language-reference/objects/my-computer-clipboard-object.md) -- [My.Computer.Clock Object](../../../visual-basic/language-reference/objects/my-computer-clock-object.md) -- [My.Computer.FileSystem Object](../../../visual-basic/language-reference/objects/my-computer-filesystem-object.md) -- [My.Computer.FileSystem.SpecialDirectories Object](../../../visual-basic/language-reference/objects/my-computer-filesystem-specialdirectories-object.md) -- [My.Computer.Info Object](../../../visual-basic/language-reference/objects/my-computer-info-object.md) -- [My.Computer.Keyboard Object](../../../visual-basic/language-reference/objects/my-computer-keyboard-object.md) -- [My.Computer.Mouse Object](../../../visual-basic/language-reference/objects/my-computer-mouse-object.md) -- [My.Computer.Network Object](../../../visual-basic/language-reference/objects/my-computer-network-object.md) -- [My.Computer.Ports Object](../../../visual-basic/language-reference/objects/my-computer-ports-object.md) -- [My.Computer.Registry Object](../../../visual-basic/language-reference/objects/my-computer-registry-object.md) +- [My.Computer.Audio Object](my-computer-audio-object.md) +- [My.Computer.Clipboard Object](my-computer-clipboard-object.md) +- [My.Computer.Clock Object](my-computer-clock-object.md) +- [My.Computer.FileSystem Object](my-computer-filesystem-object.md) +- [My.Computer.FileSystem.SpecialDirectories Object](my-computer-filesystem-specialdirectories-object.md) +- [My.Computer.Info Object](my-computer-info-object.md) +- [My.Computer.Keyboard Object](my-computer-keyboard-object.md) +- [My.Computer.Mouse Object](my-computer-mouse-object.md) +- [My.Computer.Network Object](my-computer-network-object.md) +- [My.Computer.Ports Object](my-computer-ports-object.md) +- [My.Computer.Registry Object](my-computer-registry-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-ports-object.md b/docs/visual-basic/language-reference/objects/my-computer-ports-object.md index 7b517d4f70548..8c42cfa4edd67 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-ports-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-ports-object.md @@ -12,7 +12,7 @@ Provides a property and a method for accessing the computer's serial ports. ## Remarks For information about the methods and properties of the `My.Computer.Ports` object, see . - For more information, see [Accessing the Computer's Ports](../../../visual-basic/developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md). + For more information, see [Accessing the Computer's Ports](../../developing-apps/programming/computer-resources/accessing-the-computer-s-ports.md). > [!NOTE] > You can also use properties and methods of the class to access the computer's serial ports. @@ -26,4 +26,4 @@ Provides a property and a method for accessing the computer's serial ports. ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-computer-registry-object.md b/docs/visual-basic/language-reference/objects/my-computer-registry-object.md index 85693d53c76e0..61fc11bc65ed2 100644 --- a/docs/visual-basic/language-reference/objects/my-computer-registry-object.md +++ b/docs/visual-basic/language-reference/objects/my-computer-registry-object.md @@ -12,7 +12,7 @@ Provides properties and methods for manipulating the registry. ## Remarks For information about the methods and properties of the `My.Computer.Registry` object, see . - For more information, see [Reading from and Writing to the Registry](../../../visual-basic/developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md). + For more information, see [Reading from and Writing to the Registry](../../developing-apps/programming/computer-resources/reading-from-and-writing-to-the-registry.md). > [!NOTE] > You can also manipulate the registry by using methods of the class. @@ -26,4 +26,4 @@ Provides properties and methods for manipulating the registry. ## See also -- [My.Computer Object](../../../visual-basic/language-reference/objects/my-computer-object.md) +- [My.Computer Object](my-computer-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-forms-object.md b/docs/visual-basic/language-reference/objects/my-forms-object.md index c4cf22f88d323..b9b17e2ead71e 100644 --- a/docs/visual-basic/language-reference/objects/my-forms-object.md +++ b/docs/visual-basic/language-reference/objects/my-forms-object.md @@ -69,7 +69,7 @@ This code will work only in a Windows Application project. - - - -- [Objects](../../../visual-basic/language-reference/objects/index.md) -- [Is Operator](../../../visual-basic/language-reference/operators/is-operator.md) -- [IsNot Operator](../../../visual-basic/language-reference/operators/isnot-operator.md) -- [Accessing Application Forms](../../../visual-basic/developing-apps/programming/accessing-application-forms.md) +- [Objects](index.md) +- [Is Operator](../operators/is-operator.md) +- [IsNot Operator](../operators/isnot-operator.md) +- [Accessing Application Forms](../../developing-apps/programming/accessing-application-forms.md) diff --git a/docs/visual-basic/language-reference/objects/my-log-object.md b/docs/visual-basic/language-reference/objects/my-log-object.md index 65489da88e1f1..23bb805c4ba17 100644 --- a/docs/visual-basic/language-reference/objects/my-log-object.md +++ b/docs/visual-basic/language-reference/objects/my-log-object.md @@ -11,7 +11,7 @@ Provides a property and methods for writing event and exception information to t ## Remarks For information about the methods and properties of the `My.Log` object, see . - The `My.Log` object is available for ASP.NET applications only. For client applications, use [My.Application.Log Object](../../../visual-basic/language-reference/objects/my-application-log-object.md). + The `My.Log` object is available for ASP.NET applications only. For client applications, use [My.Application.Log Object](my-application-log-object.md). ## Requirements **Namespace:** diff --git a/docs/visual-basic/language-reference/objects/my-request-object.md b/docs/visual-basic/language-reference/objects/my-request-object.md index f2296e139461b..e831f3d0ab671 100644 --- a/docs/visual-basic/language-reference/objects/my-request-object.md +++ b/docs/visual-basic/language-reference/objects/my-request-object.md @@ -24,4 +24,4 @@ Gets the object for the requested page. ## See also - -- [My.Response Object](../../../visual-basic/language-reference/objects/my-response-object.md) +- [My.Response Object](my-response-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-resources-object.md b/docs/visual-basic/language-reference/objects/my-resources-object.md index dc422e5da410f..8d0d2a98c838a 100644 --- a/docs/visual-basic/language-reference/objects/my-resources-object.md +++ b/docs/visual-basic/language-reference/objects/my-resources-object.md @@ -34,11 +34,11 @@ Provides properties and classes for accessing the application's resources. |Category|Property data type| |---|---| -|**Strings**|[String](../../../visual-basic/language-reference/data-types/string-data-type.md)| +|**Strings**|[String](../data-types/string-data-type.md)| |**Images**|| |**Icons**|| |**Audio**|

The class derives from the class, so it can be used with methods that take streams, such as the method.| -|**Files**|- [String](../../../visual-basic/language-reference/data-types/string-data-type.md) for text files.
- for image files.
- for icon files.
- for sound files.| +|**Files**|- [String](../data-types/string-data-type.md) for text files.
- for image files.
- for icon files.
- for sound files.| |**Other**|Determined by the information in the designer's **Type** column.| ## Classes diff --git a/docs/visual-basic/language-reference/objects/my-response-object.md b/docs/visual-basic/language-reference/objects/my-response-object.md index 63c7d71faed3b..b282da5eec8e1 100644 --- a/docs/visual-basic/language-reference/objects/my-response-object.md +++ b/docs/visual-basic/language-reference/objects/my-response-object.md @@ -24,4 +24,4 @@ Gets the object associated with the -- [My.Request Object](../../../visual-basic/language-reference/objects/my-request-object.md) +- [My.Request Object](my-request-object.md) diff --git a/docs/visual-basic/language-reference/objects/my-settings-object.md b/docs/visual-basic/language-reference/objects/my-settings-object.md index 283aae00da829..ce3afb61ba4ff 100644 --- a/docs/visual-basic/language-reference/objects/my-settings-object.md +++ b/docs/visual-basic/language-reference/objects/my-settings-object.md @@ -41,10 +41,10 @@ Provides properties and methods for accessing the application's settings. |To|See| |---|---| -|Read an application setting|[How to: Read Application Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md)| -|Change a user setting|[How to: Change User Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md)| -|Persist user settings|[How to: Persist User Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-persist-user-settings.md)| -|Create a property grid for user settings|[How to: Create Property Grids for User Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md)| +|Read an application setting|[How to: Read Application Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-read-application-settings.md)| +|Change a user setting|[How to: Change User Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-change-user-settings.md)| +|Persist user settings|[How to: Persist User Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-persist-user-settings.md)| +|Create a property grid for user settings|[How to: Create Property Grids for User Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md)| ## Example This example displays the value of the `Nickname` setting. @@ -56,8 +56,8 @@ Provides properties and methods for accessing the application's settings. ## See also - -- [How to: Read Application Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-read-application-settings.md) -- [How to: Change User Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-change-user-settings.md) -- [How to: Persist User Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-persist-user-settings.md) -- [How to: Create Property Grids for User Settings in Visual Basic](../../../visual-basic/developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md) +- [How to: Read Application Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-read-application-settings.md) +- [How to: Change User Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-change-user-settings.md) +- [How to: Persist User Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-persist-user-settings.md) +- [How to: Create Property Grids for User Settings in Visual Basic](../../developing-apps/programming/app-settings/how-to-create-property-grids-for-user-settings.md) - [Managing Application Settings (.NET)](/visualstudio/ide/managing-application-settings-dotnet) diff --git a/docs/visual-basic/language-reference/objects/my-user-object.md b/docs/visual-basic/language-reference/objects/my-user-object.md index e3415eec80e15..d642130a8f187 100644 --- a/docs/visual-basic/language-reference/objects/my-user-object.md +++ b/docs/visual-basic/language-reference/objects/my-user-object.md @@ -12,7 +12,7 @@ Provides access to information about the current user. ## Remarks For information about the methods and properties of the `My.User` object, see . - For more information, see [Accessing User Data](../../../visual-basic/developing-apps/programming/accessing-user-data.md). + For more information, see [Accessing User Data](../../developing-apps/programming/accessing-user-data.md). ## Requirements **Assembly:** Visual Basic Runtime Library (in Microsoft.VisualBasic.dll) diff --git a/docs/visual-basic/language-reference/objects/my-webservices-object.md b/docs/visual-basic/language-reference/objects/my-webservices-object.md index e383ffdac7021..a07464526ee9d 100644 --- a/docs/visual-basic/language-reference/objects/my-webservices-object.md +++ b/docs/visual-basic/language-reference/objects/my-webservices-object.md @@ -12,9 +12,9 @@ ms.assetid: f188dc05-2c75-41b6-bb68-122d1c3110a2 Provides properties for creating and accessing a single instance of each XML Web service referenced by the current project. ## Remarks - The `My.WebServices` object provides an instance of each Web service referenced by the current project. Each instance is instantiated on demand. You can access these Web services through the properties of the `My.WebServices` object. The name of the property is the same as the name of the Web service that the property accesses. Any class that inherits from is a Web service. For information about adding Web services to a project, see [Accessing Application Web Services](../../../visual-basic/developing-apps/programming/accessing-application-web-services.md). + The `My.WebServices` object provides an instance of each Web service referenced by the current project. Each instance is instantiated on demand. You can access these Web services through the properties of the `My.WebServices` object. The name of the property is the same as the name of the Web service that the property accesses. Any class that inherits from is a Web service. For information about adding Web services to a project, see [Accessing Application Web Services](../../developing-apps/programming/accessing-application-web-services.md). - The `My.WebServices` object exposes only the Web services associated with the current project. It does not provide access to Web services declared in referenced DLLs. To access a Web service that a DLL provides, you must use the qualified name of the Web service, in the form *DllName*.*WebServiceName*. For more information, see [Accessing Application Web Services](../../../visual-basic/developing-apps/programming/accessing-application-web-services.md). + The `My.WebServices` object exposes only the Web services associated with the current project. It does not provide access to Web services declared in referenced DLLs. To access a Web service that a DLL provides, you must use the qualified name of the Web service, in the form *DllName*.*WebServiceName*. For more information, see [Accessing Application Web Services](../../developing-apps/programming/accessing-application-web-services.md). The object and its properties are not available for Web applications. @@ -38,7 +38,7 @@ Provides properties for creating and accessing a single instance of each XML Web [!code-vb[VbVbalrMyWebService#1](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMyWebService/VB/Form1.vb#1)] - For this example to work, your project must reference a Web service named `Converter`, and that Web service must expose the `ConvertTemperature` method. For more information, see [Accessing Application Web Services](../../../visual-basic/developing-apps/programming/accessing-application-web-services.md). + For this example to work, your project must reference a Web service named `Converter`, and that Web service must expose the `ConvertTemperature` method. For more information, see [Accessing Application Web Services](../../developing-apps/programming/accessing-application-web-services.md). This code does not work in a Web application project. @@ -60,4 +60,4 @@ Provides properties for creating and accessing a single instance of each XML Web - - -- [Accessing Application Web Services](../../../visual-basic/developing-apps/programming/accessing-application-web-services.md) +- [Accessing Application Web Services](../../developing-apps/programming/accessing-application-web-services.md) diff --git a/docs/visual-basic/language-reference/objects/textfieldparser-object.md b/docs/visual-basic/language-reference/objects/textfieldparser-object.md index 390feb939577a..307943758e2fb 100644 --- a/docs/visual-basic/language-reference/objects/textfieldparser-object.md +++ b/docs/visual-basic/language-reference/objects/textfieldparser-object.md @@ -19,7 +19,7 @@ Public Class TextFieldParser ## Remarks For information about the methods and properties of the `TextFieldParser` object, see . - For more information, see [Reading from Files](../../../visual-basic/developing-apps/programming/drives-directories-files/reading-from-files.md). + For more information, see [Reading from Files](../../developing-apps/programming/drives-directories-files/reading-from-files.md). ## Requirements **Namespace:** diff --git a/docs/visual-basic/language-reference/operators/addition-assignment-operator.md b/docs/visual-basic/language-reference/operators/addition-assignment-operator.md index 203c4c6cd5329..997ffc4467948 100644 --- a/docs/visual-basic/language-reference/operators/addition-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/addition-assignment-operator.md @@ -28,19 +28,19 @@ variableorproperty += expression Required. Any numeric or `String` expression. ## Remarks - The element on the left side of the `+=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `+=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `+=` operator adds the value on its right to the variable or property on its left, and assigns the result to the variable or property on its left. The `+=` operator can also be used to concatenate the `String` expression on its right to the `String` variable or property on its left, and assign the result to the variable or property on its left. > [!NOTE] > When you use the `+=` operator, you might not be able to determine whether addition or string concatenation will occur. Use the `&=` operator for concatenation to eliminate ambiguity and to provide self-documenting code. - This assignment operator implicitly performs widening but not narrowing conversions if the compilation environment enforces strict semantics. For more information on these conversions, see [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md). For more information on strict and permissive semantics, see [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md). + This assignment operator implicitly performs widening but not narrowing conversions if the compilation environment enforces strict semantics. For more information on these conversions, see [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md). For more information on strict and permissive semantics, see [Option Strict Statement](../statements/option-strict-statement.md). - If permissive semantics are allowed, the `+=` operator implicitly performs a variety of string and numeric conversions identical to those performed by the `+` operator. For details on these conversions, see [+ Operator](../../../visual-basic/language-reference/operators/addition-operator.md). + If permissive semantics are allowed, the `+=` operator implicitly performs a variety of string and numeric conversions identical to those performed by the `+` operator. For details on these conversions, see [+ Operator](addition-operator.md). ## Overloading - The `+` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `+` operator affects the behavior of the `+=` operator. If your code uses `+=` on a class or structure that overloads `+`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `+` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `+` operator affects the behavior of the `+=` operator. If your code uses `+=` on a class or structure that overloads `+`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `+=` operator to combine the value of one variable with another. The first part uses `+=` with numeric variables to add one value to another. The second part uses `+=` with `String` variables to concatenate one value with another. In both cases, the result is assigned to the first variable. @@ -53,10 +53,10 @@ variableorproperty += expression ## See also -- [+ Operator](../../../visual-basic/language-reference/operators/addition-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Concatenation Operators](../../../visual-basic/language-reference/operators/concatenation-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [+ Operator](addition-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Concatenation Operators](concatenation-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/addition-operator.md b/docs/visual-basic/language-reference/operators/addition-operator.md index 6fd27d10b6410..e10c29479d4b9 100644 --- a/docs/visual-basic/language-reference/operators/addition-operator.md +++ b/docs/visual-basic/language-reference/operators/addition-operator.md @@ -40,7 +40,7 @@ or If `expression1` and `expression2` are both strings, the result is the concatenation of their values. - If `expression1` and `expression2` are of mixed types, the action taken depends on their types, their contents, and the setting of the [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md). For more information, see the tables in "Remarks." + If `expression1` and `expression2` are of mixed types, the action taken depends on their types, their contents, and the setting of the [Option Strict Statement](../statements/option-strict-statement.md). For more information, see the tables in "Remarks." ## Supported Types All numeric types, including the unsigned and floating-point types and `Decimal`, and `String`. @@ -52,10 +52,10 @@ or |Data types of expressions|Action by compiler| |---|---| -|Both expressions are numeric data types (`SByte`, `Byte`, `Short`, `UShort`, `Integer`, `UInteger`, `Long`, `ULong`, `Decimal`, `Single`, or `Double`)|Add. The result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md).| +|Both expressions are numeric data types (`SByte`, `Byte`, `Short`, `UShort`, `Integer`, `UInteger`, `Long`, `ULong`, `Decimal`, `Single`, or `Double`)|Add. The result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](data-types-of-operator-results.md).| |Both expressions are of type `String`|Concatenate.| |One expression is a numeric data type and the other is a string|If `Option Strict` is `On`, then generate a compiler error.

If `Option Strict` is `Off`, then implicitly convert the `String` to `Double` and add.

If the `String` cannot be converted to `Double`, then throw an exception.| -|One expression is a numeric data type, and the other is [Nothing](../../../visual-basic/language-reference/nothing.md)|Add, with `Nothing` valued as zero.| +|One expression is a numeric data type, and the other is [Nothing](../nothing.md)|Add, with `Nothing` valued as zero.| |One expression is a string, and the other is `Nothing`|Concatenate, with `Nothing` valued as "".| If one expression is an `Object` expression, Visual Basic takes the following actions. @@ -75,13 +75,13 @@ or |Both `Object` expressions are of type `String`|Concatenate.| |One `Object` expression holds a numeric value and the other holds a string|Implicitly convert the string `Object` to `Double` and add.

If the string `Object` cannot be converted to a numeric value, then throw an exception.| - If either `Object` expression evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md) or , the `+` operator treats it as a `String` with a value of "". + If either `Object` expression evaluates to [Nothing](../nothing.md) or , the `+` operator treats it as a `String` with a value of "". > [!NOTE] > When you use the `+` operator, you might not be able to determine whether addition or string concatenation will occur. Use the `&` operator for concatenation to eliminate ambiguity and to provide self-documenting code. ## Overloading - The `+` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `+` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `+` operator to add numbers. If the operands are both numeric, Visual Basic computes the arithmetic result. The arithmetic result represents the sum of the two operands. @@ -90,7 +90,7 @@ or You can also use the `+` operator to concatenate strings. If the operands are both strings, Visual Basic concatenates them. The concatenation result represents a single string consisting of the contents of the two operands one after the other. - If the operands are of mixed types, the result depends on the setting of the [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md). The following example illustrates the result when `Option Strict` is `On`. + If the operands are of mixed types, the result depends on the setting of the [Option Strict Statement](../statements/option-strict-statement.md). The following example illustrates the result when `Option Strict` is `On`. [!code-vb[VbVbalrOperators#53](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrOperators/VB/Class3.vb#53)] @@ -108,10 +108,10 @@ or ## See also -- [& Operator](../../../visual-basic/language-reference/operators/concatenation-operator.md) -- [Concatenation Operators](../../../visual-basic/language-reference/operators/concatenation-operators.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) +- [& Operator](concatenation-operator.md) +- [Concatenation Operators](concatenation-operators.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [Option Strict Statement](../statements/option-strict-statement.md) diff --git a/docs/visual-basic/language-reference/operators/addressof-operator.md b/docs/visual-basic/language-reference/operators/addressof-operator.md index a70215f7fcde6..df8d904d340eb 100644 --- a/docs/visual-basic/language-reference/operators/addressof-operator.md +++ b/docs/visual-basic/language-reference/operators/addressof-operator.md @@ -39,7 +39,7 @@ AddressOf procedurename ## See also -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Delegates](../../../visual-basic/programming-guide/language-features/delegates/index.md) +- [Declare Statement](../statements/declare-statement.md) +- [Function Statement](../statements/function-statement.md) +- [Sub Statement](../statements/sub-statement.md) +- [Delegates](../../programming-guide/language-features/delegates/index.md) diff --git a/docs/visual-basic/language-reference/operators/and-assignment-operator.md b/docs/visual-basic/language-reference/operators/and-assignment-operator.md index 223f7f383029d..0b1bc7b4e09eb 100644 --- a/docs/visual-basic/language-reference/operators/and-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/and-assignment-operator.md @@ -28,10 +28,10 @@ variableorproperty &= expression Required. Any `String` expression. ## Remarks - The element on the left side of the `&=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). The `&=` operator concatenates the `String` expression on its right to the `String` variable or property on its left, and assigns the result to the variable or property on its left. + The element on the left side of the `&=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `&=` operator concatenates the `String` expression on its right to the `String` variable or property on its left, and assigns the result to the variable or property on its left. ## Overloading - The [& Operator](../../../visual-basic/language-reference/operators/concatenation-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `&` operator affects the behavior of the `&=` operator. If your code uses `&=` on a class or structure that overloads `&`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [& Operator](concatenation-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `&` operator affects the behavior of the `&=` operator. If your code uses `&=` on a class or structure that overloads `&`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `&=` operator to concatenate two `String` variables and assign the result to the first variable. @@ -40,10 +40,10 @@ variableorproperty &= expression ## See also -- [& Operator](../../../visual-basic/language-reference/operators/concatenation-operator.md) -- [+= Operator](../../../visual-basic/language-reference/operators/addition-assignment-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Concatenation Operators](../../../visual-basic/language-reference/operators/concatenation-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [& Operator](concatenation-operator.md) +- [+= Operator](addition-assignment-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Concatenation Operators](concatenation-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/and-operator.md b/docs/visual-basic/language-reference/operators/and-operator.md index e3eb9588d2c6d..6970a8e91ba64 100644 --- a/docs/visual-basic/language-reference/operators/and-operator.md +++ b/docs/visual-basic/language-reference/operators/and-operator.md @@ -44,7 +44,7 @@ result = expression1 And expression2 |`False`|`False`|`False`| > [!NOTE] -> In a Boolean comparison, the `And` operator always evaluates both expressions, which could include making procedure calls. The [AndAlso Operator](../../../visual-basic/language-reference/operators/andalso-operator.md) performs *short-circuiting*, which means that if `expression1` is `False`, then `expression2` is not evaluated. +> In a Boolean comparison, the `And` operator always evaluates both expressions, which could include making procedure calls. The [AndAlso Operator](andalso-operator.md) performs *short-circuiting*, which means that if `expression1` is `False`, then `expression2` is not evaluated. When applied to numeric values, the `And` operator performs a bitwise comparison of identically positioned bits in two numeric expressions and sets the corresponding bit in `result` according to the following table. @@ -61,10 +61,10 @@ result = expression1 And expression2 ## Data Types If the operands consist of one `Boolean` expression and one numeric expression, Visual Basic converts the `Boolean` expression to a numeric value (–1 for `True` and 0 for `False`) and performs a bitwise operation. - For a Boolean comparison, the data type of the result is `Boolean`. For a bitwise comparison, the result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Relational and Bitwise Comparisons" table in [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md). + For a Boolean comparison, the data type of the result is `Boolean`. For a bitwise comparison, the result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Relational and Bitwise Comparisons" table in [Data Types of Operator Results](data-types-of-operator-results.md). > [!NOTE] -> The `And` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `And` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `And` operator to perform a logical conjunction on two expressions. The result is a `Boolean` value that represents whether both of the expressions are `True`. @@ -82,8 +82,8 @@ result = expression1 And expression2 ## See also -- [Logical/Bitwise Operators (Visual Basic)](../../../visual-basic/language-reference/operators/logical-bitwise-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [AndAlso Operator](../../../visual-basic/language-reference/operators/andalso-operator.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [Logical/Bitwise Operators (Visual Basic)](logical-bitwise-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [AndAlso Operator](andalso-operator.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) diff --git a/docs/visual-basic/language-reference/operators/andalso-operator.md b/docs/visual-basic/language-reference/operators/andalso-operator.md index dee51473697b5..907f12393c291 100644 --- a/docs/visual-basic/language-reference/operators/andalso-operator.md +++ b/docs/visual-basic/language-reference/operators/andalso-operator.md @@ -41,11 +41,11 @@ result = expression1 AndAlso expression2 |`False`|(not evaluated)|`False`| ## Data Types - The `AndAlso` operator is defined only for the [Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md). Visual Basic converts each operand as necessary to `Boolean` before evaluating the expression. If you assign the result to a numeric type, Visual Basic converts it from `Boolean` to that type such that `False` becomes `0` and `True` becomes `-1`. + The `AndAlso` operator is defined only for the [Boolean Data Type](../data-types/boolean-data-type.md). Visual Basic converts each operand as necessary to `Boolean` before evaluating the expression. If you assign the result to a numeric type, Visual Basic converts it from `Boolean` to that type such that `False` becomes `0` and `True` becomes `-1`. For more information, see [Boolean Type Conversions](../data-types/boolean-data-type.md#type-conversions). ## Overloading - The [And Operator](../../../visual-basic/language-reference/operators/and-operator.md) and the [IsFalse Operator](../../../visual-basic/language-reference/operators/isfalse-operator.md) can be *overloaded*, which means that a class or structure can redefine their behavior when an operand has the type of that class or structure. Overloading the `And` and `IsFalse` operators affects the behavior of the `AndAlso` operator. If your code uses `AndAlso` on a class or structure that overloads `And` and `IsFalse`, be sure you understand their redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [And Operator](and-operator.md) and the [IsFalse Operator](isfalse-operator.md) can be *overloaded*, which means that a class or structure can redefine their behavior when an operand has the type of that class or structure. Overloading the `And` and `IsFalse` operators affects the behavior of the `AndAlso` operator. If your code uses `AndAlso` on a class or structure that overloads `And` and `IsFalse`, be sure you understand their redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `AndAlso` operator to perform a logical conjunction on two expressions. The result is a `Boolean` value that represents whether the entire conjoined expression is true. If the first expression is `False`, the second is not evaluated. @@ -61,9 +61,9 @@ For more information, see [Boolean Type Conversions](../data-types/boolean-data- ## See also -- [Logical/Bitwise Operators (Visual Basic)](../../../visual-basic/language-reference/operators/logical-bitwise-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [And Operator](../../../visual-basic/language-reference/operators/and-operator.md) -- [IsFalse Operator](../../../visual-basic/language-reference/operators/isfalse-operator.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [Logical/Bitwise Operators (Visual Basic)](logical-bitwise-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [And Operator](and-operator.md) +- [IsFalse Operator](isfalse-operator.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) diff --git a/docs/visual-basic/language-reference/operators/arithmetic-operators.md b/docs/visual-basic/language-reference/operators/arithmetic-operators.md index 6f64d001583e0..2b999005084fc 100644 --- a/docs/visual-basic/language-reference/operators/arithmetic-operators.md +++ b/docs/visual-basic/language-reference/operators/arithmetic-operators.md @@ -10,21 +10,21 @@ ms.assetid: 330178e0-a375-4742-b662-b3080c89fa54 # Arithmetic Operators (Visual Basic) The following are the arithmetic operators defined in Visual Basic. - [^ Operator](../../../visual-basic/language-reference/operators/exponentiation-operator.md) + [^ Operator](exponentiation-operator.md) - [* Operator](../../../visual-basic/language-reference/operators/multiplication-operator.md) + [* Operator](multiplication-operator.md) - [/ Operator](../../../visual-basic/language-reference/operators/floating-point-division-operator.md) + [/ Operator](floating-point-division-operator.md) - [\ Operator](../../../visual-basic/language-reference/operators/integer-division-operator.md) + [\ Operator](integer-division-operator.md) - [Mod Operator](../../../visual-basic/language-reference/operators/mod-operator.md) + [Mod Operator](mod-operator.md) - [+ Operator](../../../visual-basic/language-reference/operators/addition-operator.md) (unary and binary) + [+ Operator](addition-operator.md) (unary and binary) - [- Operator](../../../visual-basic/language-reference/operators/subtraction-operator.md) (unary and binary) + [- Operator](subtraction-operator.md) (unary and binary) ## See also -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/assignment-operator.md b/docs/visual-basic/language-reference/operators/assignment-operator.md index d0534662081a3..0fb28dda20d79 100644 --- a/docs/visual-basic/language-reference/operators/assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/assignment-operator.md @@ -26,13 +26,13 @@ variableorproperty = value Any literal, constant, or expression. ## Remarks - The element on the left side of the equal sign (`=`) can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). The `=` operator assigns the value on its right to the variable or property on its left. + The element on the left side of the equal sign (`=`) can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `=` operator assigns the value on its right to the variable or property on its left. > [!NOTE] -> The `=` operator is also used as a comparison operator. For details, see [Comparison Operators](../../../visual-basic/language-reference/operators/comparison-operators.md). +> The `=` operator is also used as a comparison operator. For details, see [Comparison Operators](comparison-operators.md). ## Overloading - The `=` operator can be overloaded only as a relational comparison operator, not as an assignment operator. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `=` operator can be overloaded only as a relational comparison operator, not as an assignment operator. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example demonstrates the assignment operator. The value on the right is assigned to the variable on the left. @@ -41,14 +41,14 @@ variableorproperty = value ## See also -- [&= Operator](../../../visual-basic/language-reference/operators/and-assignment-operator.md) -- [*= Operator](../../../visual-basic/language-reference/operators/multiplication-assignment-operator.md) -- [+= Operator](../../../visual-basic/language-reference/operators/addition-assignment-operator.md) -- [-= Operator (Visual Basic)](../../../visual-basic/language-reference/operators/subtraction-assignment-operator.md) -- [/= Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-assignment-operator.md) -- [\\= Operator](../../../visual-basic/language-reference/operators/integer-division-assignment-operator.md) -- [^= Operator](../../../visual-basic/language-reference/operators/exponentiation-assignment-operator.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) -- [Comparison Operators](../../../visual-basic/language-reference/operators/comparison-operators.md) -- [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md) -- [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md) +- [&= Operator](and-assignment-operator.md) +- [*= Operator](multiplication-assignment-operator.md) +- [+= Operator](addition-assignment-operator.md) +- [-= Operator (Visual Basic)](subtraction-assignment-operator.md) +- [/= Operator (Visual Basic)](floating-point-division-assignment-operator.md) +- [\\= Operator](integer-division-assignment-operator.md) +- [^= Operator](exponentiation-assignment-operator.md) +- [Statements](../../programming-guide/language-features/statements.md) +- [Comparison Operators](comparison-operators.md) +- [ReadOnly](../modifiers/readonly.md) +- [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md) diff --git a/docs/visual-basic/language-reference/operators/assignment-operators.md b/docs/visual-basic/language-reference/operators/assignment-operators.md index e52cd6467e655..50b05d8e140e7 100644 --- a/docs/visual-basic/language-reference/operators/assignment-operators.md +++ b/docs/visual-basic/language-reference/operators/assignment-operators.md @@ -11,28 +11,28 @@ ms.assetid: 43b7e40c-b7af-45f6-b100-198a90f2561e # Assignment Operators (Visual Basic) The following are the assignment operators defined in Visual Basic. - [= Operator](../../../visual-basic/language-reference/operators/assignment-operator.md) + [= Operator](assignment-operator.md) - [^= Operator](../../../visual-basic/language-reference/operators/exponentiation-assignment-operator.md) + [^= Operator](exponentiation-assignment-operator.md) - [*= Operator](../../../visual-basic/language-reference/operators/multiplication-assignment-operator.md) + [*= Operator](multiplication-assignment-operator.md) - [/= Operator](../../../visual-basic/language-reference/operators/floating-point-division-assignment-operator.md) + [/= Operator](floating-point-division-assignment-operator.md) - [\\= Operator](../../../visual-basic/language-reference/operators/integer-division-assignment-operator.md) + [\\= Operator](integer-division-assignment-operator.md) - [+= Operator](../../../visual-basic/language-reference/operators/addition-assignment-operator.md) + [+= Operator](addition-assignment-operator.md) - [-= Operator](../../../visual-basic/language-reference/operators/subtraction-assignment-operator.md) + [-= Operator](subtraction-assignment-operator.md) - [<\<= Operator](../../../visual-basic/language-reference/operators/left-shift-assignment-operator.md) + [<\<= Operator](left-shift-assignment-operator.md) - [>>= Operator](../../../visual-basic/language-reference/operators/right-shift-assignment-operator.md) + [>>= Operator](right-shift-assignment-operator.md) - [&= Operator](../../../visual-basic/language-reference/operators/and-assignment-operator.md) + [&= Operator](and-assignment-operator.md) ## See also -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/language-reference/statements/index.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../statements/index.md) diff --git a/docs/visual-basic/language-reference/operators/await-operator.md b/docs/visual-basic/language-reference/operators/await-operator.md index 44769a55387b6..1de88bb742472 100644 --- a/docs/visual-basic/language-reference/operators/await-operator.md +++ b/docs/visual-basic/language-reference/operators/await-operator.md @@ -12,10 +12,10 @@ ms.assetid: 6b1ce283-e92b-4ba7-b081-7be7b3d37af9 You apply the `Await` operator to an operand in an asynchronous method or lambda expression to suspend execution of the method until the awaited task completes. The task represents ongoing work. -The method in which `Await` is used must have an [Async](../../../visual-basic/language-reference/modifiers/async.md) modifier. Such a method, defined by using the `Async` modifier, and usually containing one or more `Await` expressions, is referred to as an *async method*. +The method in which `Await` is used must have an [Async](../modifiers/async.md) modifier. Such a method, defined by using the `Async` modifier, and usually containing one or more `Await` expressions, is referred to as an *async method*. > [!NOTE] -> The `Async` and `Await` keywords were introduced in Visual Studio 2012. For an introduction to async programming, see [Asynchronous Programming with Async and Await](../../../visual-basic/programming-guide/concepts/async/index.md). +> The `Async` and `Await` keywords were introduced in Visual Studio 2012. For an introduction to async programming, see [Asynchronous Programming with Async and Await](../../programming-guide/concepts/async/index.md). Typically, the task to which you apply the `Await` operator is the return value from a call to a method that implements the [Task-Based Asynchronous Pattern](https://www.microsoft.com/download/details.aspx?id=19957), that is, a or a . @@ -38,7 +38,7 @@ End Function ``` > [!IMPORTANT] -> For the complete example, see [Walkthrough: Accessing the Web by Using Async and Await](../../../visual-basic/programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md). You can download the sample from [Developer Code Samples](https://code.msdn.microsoft.com/Async-Sample-Accessing-the-9c10497f) on the Microsoft website. The example is in the AsyncWalkthrough_HttpClient project. +> For the complete example, see [Walkthrough: Accessing the Web by Using Async and Await](../../programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md). You can download the sample from [Developer Code Samples](https://code.msdn.microsoft.com/Async-Sample-Accessing-the-9c10497f) on the Microsoft website. The example is in the AsyncWalkthrough_HttpClient project. If `Await` is applied to the result of a method call that returns a `Task(Of TResult)`, the type of the `Await` expression is TResult. If `Await` is applied to the result of a method call that returns a `Task`, the `Await` expression doesn't return a value. The following example illustrates the difference. @@ -64,7 +64,7 @@ If you await a task-returning async method that is canceled, the `Await` operato A single task that is in a faulted state can reflect multiple exceptions. For example, the task might be the result of a call to . When you await such a task, the await operation rethrows only one of the exceptions. However, you can't predict which of the exceptions is rethrown. -For examples of error handling in async methods, see [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md). +For examples of error handling in async methods, see [Try...Catch...Finally Statement](../statements/try-catch-finally-statement.md). ## Example @@ -102,6 +102,6 @@ End Function ## See also -- [Asynchronous Programming with Async and Await](../../../visual-basic/programming-guide/concepts/async/index.md) -- [Walkthrough: Accessing the Web by Using Async and Await](../../../visual-basic/programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md) -- [Async](../../../visual-basic/language-reference/modifiers/async.md) +- [Asynchronous Programming with Async and Await](../../programming-guide/concepts/async/index.md) +- [Walkthrough: Accessing the Web by Using Async and Await](../../programming-guide/concepts/async/walkthrough-accessing-the-web-by-using-async-and-await.md) +- [Async](../modifiers/async.md) diff --git a/docs/visual-basic/language-reference/operators/bit-shift-operators.md b/docs/visual-basic/language-reference/operators/bit-shift-operators.md index 963e47a57c7fb..f6d1f9f635f3f 100644 --- a/docs/visual-basic/language-reference/operators/bit-shift-operators.md +++ b/docs/visual-basic/language-reference/operators/bit-shift-operators.md @@ -10,10 +10,10 @@ ms.assetid: 64889319-a057-471b-85d8-69fcd4af6230 # Bit Shift Operators (Visual Basic) The following are the bit shift operators defined in Visual Basic. - [<\< Operator](../../../visual-basic/language-reference/operators/left-shift-operator.md) + [<\< Operator](left-shift-operator.md) - [>> Operator](../../../visual-basic/language-reference/operators/right-shift-operator.md) + [>> Operator](right-shift-operator.md) ## See also -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) diff --git a/docs/visual-basic/language-reference/operators/comparison-operators.md b/docs/visual-basic/language-reference/operators/comparison-operators.md index 85fbb70f83443..d17f94fa4b164 100644 --- a/docs/visual-basic/language-reference/operators/comparison-operators.md +++ b/docs/visual-basic/language-reference/operators/comparison-operators.md @@ -46,11 +46,11 @@ The following are the comparison operators defined in Visual Basic. `<>` operator - [Is Operator](../../../visual-basic/language-reference/operators/is-operator.md) + [Is Operator](is-operator.md) - [IsNot Operator](../../../visual-basic/language-reference/operators/isnot-operator.md) + [IsNot Operator](isnot-operator.md) - [Like Operator](../../../visual-basic/language-reference/operators/like-operator.md) + [Like Operator](like-operator.md) These operators compare two expressions to determine whether or not they are equal, and if not, how they differ. `Is`, `IsNot`, and `Like` are discussed in detail on separate Help pages. The relational comparison operators are discussed in detail on this page. @@ -94,7 +94,7 @@ result = string Like pattern |`<>` (Not equal to)|`expression1` <> `expression2`|`expression1` = `expression2`| > [!NOTE] -> The [= Operator](../../../visual-basic/language-reference/operators/assignment-operator.md) is also used as an assignment operator. +> The [= Operator](assignment-operator.md) is also used as an assignment operator. The `Is` operator, the `IsNot` operator, and the `Like` operator have specific comparison functionalities that differ from the operators in the preceding table. @@ -104,7 +104,7 @@ result = string Like pattern Similarly, when you compare an expression of type `Decimal` to an expression of type `Single` or `Double`, the `Decimal` expression is converted to `Single` or `Double`. For `Decimal` expressions, any fractional value less than 1E-28 might be lost. Such fractional value loss may cause two values to compare as equal when they are not. For this reason, you should take care when using equality (`=`) to compare two floating-point variables. It is safer to test whether the absolute value of the difference between the two numbers is less than a small acceptable tolerance. ### Floating-point Imprecision - When you work with floating-point numbers, keep in mind that they do not always have a precise representation in memory. This could lead to unexpected results from certain operations, such as value comparison and the [Mod Operator](../../../visual-basic/language-reference/operators/mod-operator.md). For more information, see [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md). + When you work with floating-point numbers, keep in mind that they do not always have a precise representation in memory. This could lead to unexpected results from certain operations, such as value comparison and the [Mod Operator](mod-operator.md). For more information, see [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md). ## Comparing Strings When you compare strings, the string expressions are evaluated based on their alphabetical sort order, which depends on the `Option Compare` setting. @@ -133,12 +133,12 @@ result = string Like pattern Numeric comparisons treat `Nothing` as 0. String comparisons treat `Nothing` as `""` (an empty string). ## Overloading - The relational comparison operators (`<`. `<=`, `>`, `>=`, `=`, `<>`) can be *overloaded*, which means that a class or structure can redefine their behavior when an operand has the type of that class or structure. If your code uses any of these operators on such a class or structure, be sure you understand the redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The relational comparison operators (`<`. `<=`, `>`, `>=`, `=`, `<>`) can be *overloaded*, which means that a class or structure can redefine their behavior when an operand has the type of that class or structure. If your code uses any of these operators on such a class or structure, be sure you understand the redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). - Notice that the [= Operator](../../../visual-basic/language-reference/operators/assignment-operator.md) can be overloaded only as a relational comparison operator, not as an assignment operator. + Notice that the [= Operator](assignment-operator.md) can be overloaded only as a relational comparison operator, not as an assignment operator. ## Example - The following example shows various uses of relational comparison operators, which you use to compare expressions. Relational comparison operators return a `Boolean` result that represents whether or not the stated expression evaluates to `True`. When you apply the `>` and `<` operators to strings, the comparison is made using the normal alphabetical sorting order of the strings. This order can be dependent on your locale setting. Whether the sort is case-sensitive or not depends on the [Option Compare](../../../visual-basic/language-reference/statements/option-compare-statement.md) setting. + The following example shows various uses of relational comparison operators, which you use to compare expressions. Relational comparison operators return a `Boolean` result that represents whether or not the stated expression evaluates to `True`. When you apply the `>` and `<` operators to strings, the comparison is made using the normal alphabetical sorting order of the strings. This order can be dependent on your locale setting. Whether the sort is case-sensitive or not depends on the [Option Compare](../statements/option-compare-statement.md) setting. [!code-vb[VbVbalrOperators#1](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrOperators/VB/Class1.vb#1)] @@ -147,8 +147,8 @@ result = string Like pattern ## See also - -- [= Operator](../../../visual-basic/language-reference/operators/assignment-operator.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md) -- [Comparison Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/comparison-operators.md) +- [= Operator](assignment-operator.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md) +- [Comparison Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/comparison-operators.md) diff --git a/docs/visual-basic/language-reference/operators/concatenation-operator.md b/docs/visual-basic/language-reference/operators/concatenation-operator.md index 4503a59a49442..e9d5d25ea01c7 100644 --- a/docs/visual-basic/language-reference/operators/concatenation-operator.md +++ b/docs/visual-basic/language-reference/operators/concatenation-operator.md @@ -33,13 +33,13 @@ result = expression1 & expression2 ## Remarks If the data type of `expression1` or `expression2` is not `String` but widens to `String`, it is converted to `String`. If either of the data types does not widen to `String`, the compiler generates an error. - The data type of `result` is `String`. If one or both expressions evaluate to [Nothing](../../../visual-basic/language-reference/nothing.md) or have a value of , they are treated as a string with a value of "". + The data type of `result` is `String`. If one or both expressions evaluate to [Nothing](../nothing.md) or have a value of , they are treated as a string with a value of "". > [!NOTE] -> The `&` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `&` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). > [!NOTE] -> The ampersand (&) character can also be used to identify variables as type `Long`. For more information, see [Type Characters](../../../visual-basic/programming-guide/language-features/data-types/type-characters.md). +> The ampersand (&) character can also be used to identify variables as type `Long`. For more information, see [Type Characters](../../programming-guide/language-features/data-types/type-characters.md). ## Example This example uses the `&` operator to force string concatenation. The result is a string value representing the concatenation of the two string operands. @@ -48,8 +48,8 @@ result = expression1 & expression2 ## See also -- [&= Operator](../../../visual-basic/language-reference/operators/and-assignment-operator.md) -- [Concatenation Operators](../../../visual-basic/language-reference/operators/concatenation-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Concatenation Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/concatenation-operators.md) +- [&= Operator](and-assignment-operator.md) +- [Concatenation Operators](concatenation-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Concatenation Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/concatenation-operators.md) diff --git a/docs/visual-basic/language-reference/operators/concatenation-operators.md b/docs/visual-basic/language-reference/operators/concatenation-operators.md index f7d9407f34589..35073711016d7 100644 --- a/docs/visual-basic/language-reference/operators/concatenation-operators.md +++ b/docs/visual-basic/language-reference/operators/concatenation-operators.md @@ -9,13 +9,13 @@ ms.assetid: d787368b-3713-47ff-bce8-f112720a673a # Concatenation Operators (Visual Basic) The following are the concatenation operators defined in Visual Basic. - [& Operator](../../../visual-basic/language-reference/operators/concatenation-operator.md) + [& Operator](concatenation-operator.md) - [+ Operator](../../../visual-basic/language-reference/operators/addition-operator.md) + [+ Operator](addition-operator.md) ## See also - - -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Concatenation Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/concatenation-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Concatenation Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/concatenation-operators.md) diff --git a/docs/visual-basic/language-reference/operators/data-types-of-operator-results.md b/docs/visual-basic/language-reference/operators/data-types-of-operator-results.md index 2a488d2c920fe..550be00c148e7 100644 --- a/docs/visual-basic/language-reference/operators/data-types-of-operator-results.md +++ b/docs/visual-basic/language-reference/operators/data-types-of-operator-results.md @@ -16,36 +16,36 @@ Visual Basic determines the result data type of an operation based on the data t ## Data Type Ranges The ranges of the relevant data types, in order from smallest to largest, are as follows: -- [Boolean](../../../visual-basic/language-reference/data-types/boolean-data-type.md) — two possible values +- [Boolean](../data-types/boolean-data-type.md) — two possible values -- [SByte](../../../visual-basic/language-reference/data-types/sbyte-data-type.md), [Byte](../../../visual-basic/language-reference/data-types/byte-data-type.md) — 256 possible integral values +- [SByte](../data-types/sbyte-data-type.md), [Byte](../data-types/byte-data-type.md) — 256 possible integral values -- [Short](../../../visual-basic/language-reference/data-types/short-data-type.md), [UShort](../../../visual-basic/language-reference/data-types/ushort-data-type.md) — 65,536 (6.5...E+4) possible integral values +- [Short](../data-types/short-data-type.md), [UShort](../data-types/ushort-data-type.md) — 65,536 (6.5...E+4) possible integral values -- [Integer](../../../visual-basic/language-reference/data-types/integer-data-type.md), [UInteger](../../../visual-basic/language-reference/data-types/uinteger-data-type.md) — 4,294,967,296 (4.2...E+9) possible integral values +- [Integer](../data-types/integer-data-type.md), [UInteger](../data-types/uinteger-data-type.md) — 4,294,967,296 (4.2...E+9) possible integral values -- [Long](../../../visual-basic/language-reference/data-types/long-data-type.md), [ULong](../../../visual-basic/language-reference/data-types/ulong-data-type.md) — 18,446,744,073,709,551,615 (1.8...E+19) possible integral values +- [Long](../data-types/long-data-type.md), [ULong](../data-types/ulong-data-type.md) — 18,446,744,073,709,551,615 (1.8...E+19) possible integral values -- [Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md) — 1.5...E+29 possible integral values, maximum range 7.9...E+28 (absolute value) +- [Decimal](../data-types/decimal-data-type.md) — 1.5...E+29 possible integral values, maximum range 7.9...E+28 (absolute value) -- [Single](../../../visual-basic/language-reference/data-types/single-data-type.md) — maximum range 3.4...E+38 (absolute value) +- [Single](../data-types/single-data-type.md) — maximum range 3.4...E+38 (absolute value) -- [Double](../../../visual-basic/language-reference/data-types/double-data-type.md) — maximum range 1.7...E+308 (absolute value) +- [Double](../data-types/double-data-type.md) — maximum range 1.7...E+308 (absolute value) - For more information on Visual Basic data types, see [Data Types](../../../visual-basic/language-reference/data-types/index.md). + For more information on Visual Basic data types, see [Data Types](../data-types/index.md). - If an operand evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), the Visual Basic arithmetic operators treat it as zero. + If an operand evaluates to [Nothing](../nothing.md), the Visual Basic arithmetic operators treat it as zero. ## Decimal Arithmetic - Note that the [Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md) data type is neither floating-point nor integer. + Note that the [Decimal](../data-types/decimal-data-type.md) data type is neither floating-point nor integer. If either operand of a `+`, `–`, `*`, `/`, or `Mod` operation is `Decimal` and the other is not `Single` or `Double`, Visual Basic widens the other operand to `Decimal`. It performs the operation in `Decimal`, and the result data type is `Decimal`. ## Floating-Point Arithmetic - Visual Basic performs most floating-point arithmetic in [Double](../../../visual-basic/language-reference/data-types/double-data-type.md), which is the most efficient data type for such operations. However, if one operand is [Single](../../../visual-basic/language-reference/data-types/single-data-type.md) and the other is not `Double`, Visual Basic performs the operation in `Single`. It widens each operand as necessary to the appropriate data type before the operation, and the result has that data type. + Visual Basic performs most floating-point arithmetic in [Double](../data-types/double-data-type.md), which is the most efficient data type for such operations. However, if one operand is [Single](../data-types/single-data-type.md) and the other is not `Double`, Visual Basic performs the operation in `Single`. It widens each operand as necessary to the appropriate data type before the operation, and the result has that data type. ### / and ^ Operators - The `/` operator is defined only for the [Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md), [Single](../../../visual-basic/language-reference/data-types/single-data-type.md), and [Double](../../../visual-basic/language-reference/data-types/double-data-type.md) data types. Visual Basic widens each operand as necessary to the appropriate data type before the operation, and the result has that data type. + The `/` operator is defined only for the [Decimal](../data-types/decimal-data-type.md), [Single](../data-types/single-data-type.md), and [Double](../data-types/double-data-type.md) data types. Visual Basic widens each operand as necessary to the appropriate data type before the operation, and the result has that data type. The following table shows the result data types for the `/` operator. Note that this table is symmetric; for a given combination of operand data types, the result data type is the same regardless of the order of the operands. @@ -124,10 +124,10 @@ Visual Basic determines the result data type of an operation based on the data t |`Long`|Long|Long|Long|Long|Long|Long|Long|Long|Long| |`ULong`|Long|Long|ULong|Long|ULong|Long|ULong|Long|ULong| - If either operand of the `\` operator is [Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md), [Single](../../../visual-basic/language-reference/data-types/single-data-type.md), or [Double](../../../visual-basic/language-reference/data-types/double-data-type.md), Visual Basic attempts to convert it to [Long](../../../visual-basic/language-reference/data-types/long-data-type.md) before the operation, and the result data type is `Long`. + If either operand of the `\` operator is [Decimal](../data-types/decimal-data-type.md), [Single](../data-types/single-data-type.md), or [Double](../data-types/double-data-type.md), Visual Basic attempts to convert it to [Long](../data-types/long-data-type.md) before the operation, and the result data type is `Long`. ## Relational and Bitwise Comparisons - The result data type of a relational operation (`=`, `<>`, `<`, `>`, `<=`, `>=`) is always `Boolean`[Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md). The same is true for logical operations (`And`, `AndAlso`, `Not`, `Or`, `OrElse`, `Xor`) on `Boolean` operands. + The result data type of a relational operation (`=`, `<>`, `<`, `>`, `<=`, `>=`) is always `Boolean`[Boolean Data Type](../data-types/boolean-data-type.md). The same is true for logical operations (`And`, `AndAlso`, `Not`, `Or`, `OrElse`, `Xor`) on `Boolean` operands. The result data type of a bitwise logical operation depends on the data types of the operands. Note that `AndAlso` and `OrElse` are defined only for `Boolean`, and Visual Basic converts each operand as necessary to `Boolean` before performing the operation. @@ -171,13 +171,13 @@ Visual Basic determines the result data type of an operation based on the data t ## See also -- [Data Types](../../../visual-basic/language-reference/data-types/index.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) -- [Comparison Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/comparison-operators.md) -- [Operators](../../../visual-basic/language-reference/operators/index.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Comparison Operators](../../../visual-basic/language-reference/operators/comparison-operators.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) +- [Data Types](../data-types/index.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [Comparison Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/comparison-operators.md) +- [Operators](index.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Comparison Operators](comparison-operators.md) +- [Option Strict Statement](../statements/option-strict-statement.md) diff --git a/docs/visual-basic/language-reference/operators/directcast-operator.md b/docs/visual-basic/language-reference/operators/directcast-operator.md index e4ddb660c02c4..c72480ff339bc 100644 --- a/docs/visual-basic/language-reference/operators/directcast-operator.md +++ b/docs/visual-basic/language-reference/operators/directcast-operator.md @@ -14,7 +14,7 @@ Introduces a type conversion operation based on inheritance or implementation. ## Remarks `DirectCast` does not use the Visual Basic run-time helper routines for conversion, so it can provide somewhat better performance than `CType` when converting to and from data type `Object`. - You use the `DirectCast` keyword similar to the way you use the [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) and the [TryCast Operator](../../../visual-basic/language-reference/operators/trycast-operator.md) keyword. You supply an expression as the first argument and a type to convert it to as the second argument. `DirectCast` requires an inheritance or implementation relationship between the data types of the two arguments. This means that one type must inherit from or implement the other. + You use the `DirectCast` keyword similar to the way you use the [CType Function](../functions/ctype-function.md) and the [TryCast Operator](trycast-operator.md) keyword. You supply an expression as the first argument and a type to convert it to as the second argument. `DirectCast` requires an inheritance or implementation relationship between the data types of the two arguments. This means that one type must inherit from or implement the other. ## Errors and Failures `DirectCast` generates a compiler error if it detects that no inheritance or implementation relationship exists. But the lack of a compiler error does not guarantee a successful conversion. If the desired conversion is narrowing, it could fail at run time. If this happens, the runtime throws an error. @@ -24,9 +24,9 @@ Introduces a type conversion operation based on inheritance or implementation. |Keyword|Data types|Argument relationship|Run-time failure| |---|---|---|---| -|[CType Function](../../../visual-basic/language-reference/functions/ctype-function.md)|Any data types|Widening or narrowing conversion must be defined between the two data types|Throws | +|[CType Function](../functions/ctype-function.md)|Any data types|Widening or narrowing conversion must be defined between the two data types|Throws | |`DirectCast`|Any data types|One type must inherit from or implement the other type|Throws | -|[TryCast Operator](../../../visual-basic/language-reference/operators/trycast-operator.md)|Reference types only|One type must inherit from or implement the other type|Returns [Nothing](../../../visual-basic/language-reference/nothing.md)| +|[TryCast Operator](trycast-operator.md)|Reference types only|One type must inherit from or implement the other type|Returns [Nothing](../nothing.md)| ## Example The following example demonstrates two uses of `DirectCast`, one that fails at run time and one that succeeds. @@ -38,5 +38,5 @@ Introduces a type conversion operation based on inheritance or implementation. ## See also - -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) diff --git a/docs/visual-basic/language-reference/operators/exponentiation-assignment-operator.md b/docs/visual-basic/language-reference/operators/exponentiation-assignment-operator.md index 47870e6723137..dece54b57ab6f 100644 --- a/docs/visual-basic/language-reference/operators/exponentiation-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/exponentiation-assignment-operator.md @@ -27,16 +27,16 @@ variableorproperty ^= expression Required. Any numeric expression. ## Remarks - The element on the left side of the `^=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `^=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `^=` operator first raises the value of the variable or property (on the left-hand side of the operator) to the power of the value of the expression (on the right-hand side of the operator). The operator then assigns the result of that operation back to the variable or property. - Visual Basic always performs exponentiation in the [Double Data Type](../../../visual-basic/language-reference/data-types/double-data-type.md). Operands of any different type are converted to `Double`, and the result is always `Double`. + Visual Basic always performs exponentiation in the [Double Data Type](../data-types/double-data-type.md). Operands of any different type are converted to `Double`, and the result is always `Double`. The value of `expression` can be fractional, negative, or both. ## Overloading - The [^ Operator](../../../visual-basic/language-reference/operators/exponentiation-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `^` operator affects the behavior of the `^=` operator. If your code uses `^=` on a class or structure that overloads `^`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [^ Operator](exponentiation-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `^` operator affects the behavior of the `^=` operator. If your code uses `^=` on a class or structure that overloads `^`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `^=` operator to raise the value of one `Integer` variable to the power of a second variable and assign the result to the first variable. @@ -45,9 +45,9 @@ variableorproperty ^= expression ## See also -- [^ Operator](../../../visual-basic/language-reference/operators/exponentiation-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [^ Operator](exponentiation-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/exponentiation-operator.md b/docs/visual-basic/language-reference/operators/exponentiation-operator.md index 1f5b75cf3bd9f..e9b14133eafc4 100644 --- a/docs/visual-basic/language-reference/operators/exponentiation-operator.md +++ b/docs/visual-basic/language-reference/operators/exponentiation-operator.md @@ -44,14 +44,14 @@ The result is `number` raised to the power of `exponent`, always as a `Double` v ## Remarks -Visual Basic always performs exponentiation in the [Double Data Type](../../../visual-basic/language-reference/data-types/double-data-type.md). +Visual Basic always performs exponentiation in the [Double Data Type](../data-types/double-data-type.md). The value of `exponent` can be fractional, negative, or both. When more than one exponentiation is performed in a single expression, the `^` operator is evaluated as it is encountered from left to right. > [!NOTE] -> The `^` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `^` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example @@ -81,8 +81,8 @@ Note the importance of the parentheses in the expressions in the preceding examp ## See also -- [^= Operator](../../../visual-basic/language-reference/operators/exponentiation-assignment-operator.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [^= Operator](exponentiation-assignment-operator.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/floating-point-division-assignment-operator.md b/docs/visual-basic/language-reference/operators/floating-point-division-assignment-operator.md index 854e875d42f9c..6470612edd79a 100644 --- a/docs/visual-basic/language-reference/operators/floating-point-division-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/floating-point-division-assignment-operator.md @@ -28,14 +28,14 @@ variableorproperty /= expression Required. Any numeric expression. ## Remarks - The element on the left side of the `/=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `/=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `/=` operator first divides the value of the variable or property (on the left-hand side of the operator) by the value of the expression (on the right-hand side of the operator). The operator then assigns the floating-point result of that operation to the variable or property. - This statement assigns a `Double` value to the variable or property on the left. If `Option Strict` is `On`, `variableorproperty` must be a `Double`. If `Option Strict` is `Off`, Visual Basic performs an implicit conversion and assigns the resulting value to `variableorproperty`, with a possible error at run time. For more information, see [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) and [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md). + This statement assigns a `Double` value to the variable or property on the left. If `Option Strict` is `On`, `variableorproperty` must be a `Double`. If `Option Strict` is `Off`, Visual Basic performs an implicit conversion and assigns the resulting value to `variableorproperty`, with a possible error at run time. For more information, see [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) and [Option Strict Statement](../statements/option-strict-statement.md). ## Overloading - The [/ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `/` operator affects the behavior of the `/=` operator. If your code uses `/=` on a class or structure that overloads `/`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [/ Operator (Visual Basic)](floating-point-division-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `/` operator affects the behavior of the `/=` operator. If your code uses `/=` on a class or structure that overloads `/`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `/=` operator to divide one `Integer` variable by a second and assign the quotient to the first variable. @@ -44,10 +44,10 @@ variableorproperty /= expression ## See also -- [/ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-operator.md) -- [\\= Operator](../../../visual-basic/language-reference/operators/integer-division-assignment-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [/ Operator (Visual Basic)](floating-point-division-operator.md) +- [\\= Operator](integer-division-assignment-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/floating-point-division-operator.md b/docs/visual-basic/language-reference/operators/floating-point-division-operator.md index 5996ded80747d..d45745560edc8 100644 --- a/docs/visual-basic/language-reference/operators/floating-point-division-operator.md +++ b/docs/visual-basic/language-reference/operators/floating-point-division-operator.md @@ -39,21 +39,21 @@ expression1 / expression2 ## Result The result is the full quotient of `expression1` divided by `expression2`, including any remainder. - The [\ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/integer-division-operator.md) returns the integer quotient, which drops the remainder. + The [\ Operator (Visual Basic)](integer-division-operator.md) returns the integer quotient, which drops the remainder. ## Remarks The data type of the result depends on the types of the operands. The following table shows how the data type of the result is determined. |Operand data types|Result data type| |------------------------|----------------------| -|Both expressions are integral data types ([SByte](../../../visual-basic/language-reference/data-types/sbyte-data-type.md), [Byte](../../../visual-basic/language-reference/data-types/byte-data-type.md), [Short](../../../visual-basic/language-reference/data-types/short-data-type.md), [UShort](../../../visual-basic/language-reference/data-types/ushort-data-type.md), [Integer](../../../visual-basic/language-reference/data-types/integer-data-type.md), [UInteger](../../../visual-basic/language-reference/data-types/uinteger-data-type.md), [Long](../../../visual-basic/language-reference/data-types/long-data-type.md), [ULong](../../../visual-basic/language-reference/data-types/ulong-data-type.md))|`Double`| -|One expression is a [Single](../../../visual-basic/language-reference/data-types/single-data-type.md) data type and the other is not a [Double](../../../visual-basic/language-reference/data-types/double-data-type.md)|`Single`| -|One expression is a [Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md) data type and the other is not a [Single](../../../visual-basic/language-reference/data-types/single-data-type.md) or a [Double](../../../visual-basic/language-reference/data-types/double-data-type.md)|`Decimal`| -|Either expression is a [Double](../../../visual-basic/language-reference/data-types/double-data-type.md) data type|`Double`| +|Both expressions are integral data types ([SByte](../data-types/sbyte-data-type.md), [Byte](../data-types/byte-data-type.md), [Short](../data-types/short-data-type.md), [UShort](../data-types/ushort-data-type.md), [Integer](../data-types/integer-data-type.md), [UInteger](../data-types/uinteger-data-type.md), [Long](../data-types/long-data-type.md), [ULong](../data-types/ulong-data-type.md))|`Double`| +|One expression is a [Single](../data-types/single-data-type.md) data type and the other is not a [Double](../data-types/double-data-type.md)|`Single`| +|One expression is a [Decimal](../data-types/decimal-data-type.md) data type and the other is not a [Single](../data-types/single-data-type.md) or a [Double](../data-types/double-data-type.md)|`Decimal`| +|Either expression is a [Double](../data-types/double-data-type.md) data type|`Double`| Before division is performed, any integral numeric expressions are widened to `Double`. If you assign the result to an integral data type, Visual Basic attempts to convert the result from `Double` to that type. This can throw an exception if the result does not fit in that type. In particular, see "Attempted Division by Zero" on this Help page. - If `expression1` or `expression2` evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), it is treated as zero. + If `expression1` or `expression2` evaluates to [Nothing](../nothing.md), it is treated as zero. ## Attempted Division by Zero If `expression2` evaluates to zero, the `/` operator behaves differently for different operand data types. The following table shows the possible behaviors. @@ -65,7 +65,7 @@ expression1 / expression2 |Integral (signed or unsigned)|Attempted conversion back to integral type throws because integral types cannot accept , , or | > [!NOTE] -> The `/` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `/` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example This example uses the `/` operator to perform floating-point division. The result is the quotient of the two operands. @@ -76,10 +76,10 @@ expression1 / expression2 ## See also -- [/= Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-assignment-operator.md) -- [\ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/integer-division-operator.md) -- [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [/= Operator (Visual Basic)](floating-point-division-assignment-operator.md) +- [\ Operator (Visual Basic)](integer-division-operator.md) +- [Data Types of Operator Results](data-types-of-operator-results.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/function-expression.md b/docs/visual-basic/language-reference/operators/function-expression.md index fba8d7ca82a72..2fe90315efc9c 100644 --- a/docs/visual-basic/language-reference/operators/function-expression.md +++ b/docs/visual-basic/language-reference/operators/function-expression.md @@ -24,12 +24,12 @@ End Function |Term|Definition| |---|---| -|`parameterlist`|Optional. A list of local variable names that represent the parameters of this procedure. The parentheses must be present even when the list is empty. See [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md).| +|`parameterlist`|Optional. A list of local variable names that represent the parameters of this procedure. The parentheses must be present even when the list is empty. See [Parameter List](../statements/parameter-list.md).| |`expression`|Required. A single expression. The type of the expression is the return type of the function.| -|`statements`|Required. A list of statements that returns a value by using the `Return` statement. (See [Return Statement](../../../visual-basic/language-reference/statements/return-statement.md).) The type of the value returned is the return type of the function.| +|`statements`|Required. A list of statements that returns a value by using the `Return` statement. (See [Return Statement](../statements/return-statement.md).) The type of the value returned is the return type of the function.| ## Remarks - A *lambda expression* is a function without a name that calculates and returns a value. You can use a lambda expression anywhere you can use a delegate type, except as an argument to `RemoveHandler`. For more information about delegates, and the use of lambda expressions with delegates, see [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) and [Relaxed Delegate Conversion](../../../visual-basic/programming-guide/language-features/delegates/relaxed-delegate-conversion.md). + A *lambda expression* is a function without a name that calculates and returns a value. You can use a lambda expression anywhere you can use a delegate type, except as an argument to `RemoveHandler`. For more information about delegates, and the use of lambda expressions with delegates, see [Delegate Statement](../statements/delegate-statement.md) and [Relaxed Delegate Conversion](../../programming-guide/language-features/delegates/relaxed-delegate-conversion.md). ## Lambda Expression Syntax The syntax of a lambda expression resembles that of a standard function. The differences are as follows: @@ -61,7 +61,7 @@ End Function [!code-vb[VbVbalrLambdas#3](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrLambdas/VB/Class1.vb#3)] ## Example - Following is an example of a lambda expression that increments its argument and returns the value. The example shows both the single-line and multiline lambda expression syntax for a function. For more examples, see [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md). + Following is an example of a lambda expression that increments its argument and returns the value. The example shows both the single-line and multiline lambda expression syntax for a function. For more examples, see [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md). [!code-vb[VbVbalrLambdas#14](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrLambdas/VB/Class1.vb#14)] @@ -79,15 +79,15 @@ Dim londonCusts = db.Customers. Select(Function(cust) cust) ``` - For more information about query methods, see [Queries](../../../visual-basic/language-reference/queries/index.md). For more information about standard query operators, see [Standard Query Operators Overview](../../programming-guide/concepts/linq/standard-query-operators-overview.md). + For more information about query methods, see [Queries](../queries/index.md). For more information about standard query operators, see [Standard Query Operators Overview](../../programming-guide/concepts/linq/standard-query-operators-overview.md). ## See also -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) -- [Value Comparisons](../../../visual-basic/programming-guide/language-features/operators-and-expressions/value-comparisons.md) -- [Boolean Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/boolean-expressions.md) -- [If Operator](../../../visual-basic/language-reference/operators/if-operator.md) -- [Relaxed Delegate Conversion](../../../visual-basic/programming-guide/language-features/delegates/relaxed-delegate-conversion.md) +- [Function Statement](../statements/function-statement.md) +- [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) +- [Statements](../../programming-guide/language-features/statements.md) +- [Value Comparisons](../../programming-guide/language-features/operators-and-expressions/value-comparisons.md) +- [Boolean Expressions](../../programming-guide/language-features/operators-and-expressions/boolean-expressions.md) +- [If Operator](if-operator.md) +- [Relaxed Delegate Conversion](../../programming-guide/language-features/delegates/relaxed-delegate-conversion.md) diff --git a/docs/visual-basic/language-reference/operators/gettype-operator.md b/docs/visual-basic/language-reference/operators/gettype-operator.md index 279b0b85ad243..e0c76742720d2 100644 --- a/docs/visual-basic/language-reference/operators/gettype-operator.md +++ b/docs/visual-basic/language-reference/operators/gettype-operator.md @@ -53,6 +53,6 @@ GetType(typename) ## See also -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) diff --git a/docs/visual-basic/language-reference/operators/getxmlnamespace-operator.md b/docs/visual-basic/language-reference/operators/getxmlnamespace-operator.md index ff40cddd34c24..167ffed0d4504 100644 --- a/docs/visual-basic/language-reference/operators/getxmlnamespace-operator.md +++ b/docs/visual-basic/language-reference/operators/getxmlnamespace-operator.md @@ -20,7 +20,7 @@ GetXmlNamespace(xmlNamespacePrefix) ## Parts `xmlNamespacePrefix` - Optional. The string that identifies the XML namespace prefix. If supplied, this string must be a valid XML identifier. For more information, see [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md). If no prefix is specified, the default namespace is returned. If no default namespace is specified, the empty namespace is returned. + Optional. The string that identifies the XML namespace prefix. If supplied, this string must be a valid XML identifier. For more information, see [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md). If no prefix is specified, the default namespace is returned. If no default namespace is specified, the empty namespace is returned. ## Return Value The object that corresponds to the XML namespace prefix. @@ -41,5 +41,5 @@ GetXmlNamespace(xmlNamespacePrefix) ## See also -- [Imports Statement (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md) -- [Accessing XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/accessing-xml.md) +- [Imports Statement (XML Namespace)](../statements/imports-statement-xml-namespace.md) +- [Accessing XML in Visual Basic](../../programming-guide/language-features/xml/accessing-xml.md) diff --git a/docs/visual-basic/language-reference/operators/if-operator.md b/docs/visual-basic/language-reference/operators/if-operator.md index dcf5ca4309f15..9b2464a327aef 100644 --- a/docs/visual-basic/language-reference/operators/if-operator.md +++ b/docs/visual-basic/language-reference/operators/if-operator.md @@ -32,7 +32,7 @@ When `If` is called by using three arguments, the first argument must evaluate t |---|---| |`argument1`|Required. `Boolean`. Determines which of the other arguments to evaluate and return.| |`argument2`|Required. `Object`. Evaluated and returned if `argument1` evaluates to `True`.| -|`argument3`|Required. `Object`. Evaluated and returned if `argument1` evaluates to `False` or if `argument1` is a [Nullable](../../../visual-basic/programming-guide/language-features/data-types/nullable-value-types.md)`Boolean` variable that evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md).| +|`argument3`|Required. `Object`. Evaluated and returned if `argument1` evaluates to `False` or if `argument1` is a [Nullable](../../programming-guide/language-features/data-types/nullable-value-types.md)`Boolean` variable that evaluates to [Nothing](../nothing.md).| An `If` operator that is called with three arguments works like an `IIf` function except that it uses short-circuit evaluation. An `IIf` function always evaluates all three of its arguments, whereas an `If` operator that has three arguments evaluates only two of them. The first `If` argument is evaluated and the result is cast as a `Boolean` value, `True` or `False`. If the value is `True`, `argument2` is evaluated and its value is returned, but `argument3` is not evaluated. If the value of the `Boolean` expression is `False`, `argument3` is evaluated and its value is returned, but `argument2` is not evaluated. The following examples illustrate the use of `If` when three arguments are used: diff --git a/docs/visual-basic/language-reference/operators/integer-division-assignment-operator.md b/docs/visual-basic/language-reference/operators/integer-division-assignment-operator.md index 276022a9b8006..12dabb9579d79 100644 --- a/docs/visual-basic/language-reference/operators/integer-division-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/integer-division-assignment-operator.md @@ -29,14 +29,14 @@ variableorproperty \= expression Required. Any numeric expression. ## Remarks - The element on the left side of the `\=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `\=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `\=` operator divides the value of a variable or property on its left by the value on its right, and assigns the integer result to the variable or property on its left - For further information on integer division, see [\ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/integer-division-operator.md). + For further information on integer division, see [\ Operator (Visual Basic)](integer-division-operator.md). ## Overloading - The `\` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `\` operator affects the behavior of the `\=` operator. If your code uses `\=` on a class or structure that overloads `\`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `\` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `\` operator affects the behavior of the `\=` operator. If your code uses `\=` on a class or structure that overloads `\`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `\=` operator to divide one `Integer` variable by a second and assign the integer result to the first variable. @@ -45,10 +45,10 @@ variableorproperty \= expression ## See also -- [\ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/integer-division-operator.md) -- [/= Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-assignment-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [\ Operator (Visual Basic)](integer-division-operator.md) +- [/= Operator (Visual Basic)](floating-point-division-assignment-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/integer-division-operator.md b/docs/visual-basic/language-reference/operators/integer-division-operator.md index 18c7fff9dbc82..cf29f422daf71 100644 --- a/docs/visual-basic/language-reference/operators/integer-division-operator.md +++ b/docs/visual-basic/language-reference/operators/integer-division-operator.md @@ -40,20 +40,20 @@ expression1 \ expression2 ## Result The result is the integer quotient of `expression1` divided by `expression2`, which discards any remainder and retains only the integer portion. This is known as *truncation*. - The result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md). + The result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](data-types-of-operator-results.md). - The [/ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-operator.md) returns the full quotient, which retains the remainder in the fractional portion. + The [/ Operator (Visual Basic)](floating-point-division-operator.md) returns the full quotient, which retains the remainder in the fractional portion. ## Remarks - Before performing the division, Visual Basic attempts to convert any floating-point numeric expression to `Long`. If `Option Strict` is `On`, a compiler error occurs. If `Option Strict` is `Off`, an is possible if the value is outside the range of the [Long Data Type](../../../visual-basic/language-reference/data-types/long-data-type.md). The conversion to `Long` is also subject to *banker's rounding*. For more information, see "Fractional Parts" in [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md). + Before performing the division, Visual Basic attempts to convert any floating-point numeric expression to `Long`. If `Option Strict` is `On`, a compiler error occurs. If `Option Strict` is `Off`, an is possible if the value is outside the range of the [Long Data Type](../data-types/long-data-type.md). The conversion to `Long` is also subject to *banker's rounding*. For more information, see "Fractional Parts" in [Type Conversion Functions](../functions/type-conversion-functions.md). - If `expression1` or `expression2` evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), it is treated as zero. + If `expression1` or `expression2` evaluates to [Nothing](../nothing.md), it is treated as zero. ## Attempted Division by Zero If `expression2` evaluates to zero, the `\` operator throws a exception. This is true for all numeric data types of the operands. > [!NOTE] -> The `\` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `\` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `\` operator to perform integer division. The result is an integer that represents the integer quotient of the two operands, with the remainder discarded. @@ -64,10 +64,10 @@ expression1 \ expression2 ## See also -- [\\= Operator](../../../visual-basic/language-reference/operators/integer-division-assignment-operator.md) -- [/ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-operator.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [\\= Operator](integer-division-assignment-operator.md) +- [/ Operator (Visual Basic)](floating-point-division-operator.md) +- [Option Strict Statement](../statements/option-strict-statement.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/is-operator.md b/docs/visual-basic/language-reference/operators/is-operator.md index 4f07e430538f2..b35921bf4764b 100644 --- a/docs/visual-basic/language-reference/operators/is-operator.md +++ b/docs/visual-basic/language-reference/operators/is-operator.md @@ -35,7 +35,7 @@ result = object1 Is object2 `Is` can also be used with the `TypeOf` keyword to make a `TypeOf`...`Is` expression, which tests whether an object variable is compatible with a data type. > [!NOTE] -> The `Is` keyword is also used in the [Select...Case Statement](../../../visual-basic/language-reference/statements/select-case-statement.md). +> The `Is` keyword is also used in the [Select...Case Statement](../statements/select-case-statement.md). ## Example The following example uses the `Is` operator to compare pairs of object references. The results are assigned to a `Boolean` value representing whether the two objects are identical. @@ -46,9 +46,9 @@ result = object1 Is object2 ## See also -- [TypeOf Operator](../../../visual-basic/language-reference/operators/typeof-operator.md) -- [IsNot Operator](../../../visual-basic/language-reference/operators/isnot-operator.md) -- [Comparison Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/comparison-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) +- [TypeOf Operator](typeof-operator.md) +- [IsNot Operator](isnot-operator.md) +- [Comparison Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/comparison-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) diff --git a/docs/visual-basic/language-reference/operators/isfalse-operator.md b/docs/visual-basic/language-reference/operators/isfalse-operator.md index c1e506dc5ae0f..6165041d32b4c 100644 --- a/docs/visual-basic/language-reference/operators/isfalse-operator.md +++ b/docs/visual-basic/language-reference/operators/isfalse-operator.md @@ -16,7 +16,7 @@ Determines whether an expression is `False`. The compiler considers the `IsFalse` and `IsTrue` operators as a *matched pair*. This means that if you define one of them, you must also define the other one. > [!NOTE] -> The `IsFalse` operator can be *overloaded*, which means that a class or structure can redefine its behavior when its operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `IsFalse` operator can be *overloaded*, which means that a class or structure can redefine its behavior when its operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following code example defines the outline of a structure that includes definitions for the `IsFalse` and `IsTrue` operators. @@ -25,6 +25,6 @@ Determines whether an expression is `False`. ## See also -- [IsTrue Operator](../../../visual-basic/language-reference/operators/istrue-operator.md) -- [How to: Define an Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-an-operator.md) -- [AndAlso Operator](../../../visual-basic/language-reference/operators/andalso-operator.md) +- [IsTrue Operator](istrue-operator.md) +- [How to: Define an Operator](../../programming-guide/language-features/procedures/how-to-define-an-operator.md) +- [AndAlso Operator](andalso-operator.md) diff --git a/docs/visual-basic/language-reference/operators/istrue-operator.md b/docs/visual-basic/language-reference/operators/istrue-operator.md index f62b502e23f7b..0c75fec5b3619 100644 --- a/docs/visual-basic/language-reference/operators/istrue-operator.md +++ b/docs/visual-basic/language-reference/operators/istrue-operator.md @@ -31,7 +31,7 @@ Determines whether an expression is `True`. If you have not defined any conversion to `Boolean` or an `IsTrue` operator, the compiler signals an error. > [!NOTE] -> The `IsTrue` operator can be *overloaded*, which means that a class or structure can redefine its behavior when its operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `IsTrue` operator can be *overloaded*, which means that a class or structure can redefine its behavior when its operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following code example defines the outline of a structure that includes definitions for the `IsFalse` and `IsTrue` operators. @@ -40,6 +40,6 @@ Determines whether an expression is `True`. ## See also -- [IsFalse Operator](../../../visual-basic/language-reference/operators/isfalse-operator.md) -- [How to: Define an Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-an-operator.md) -- [OrElse Operator](../../../visual-basic/language-reference/operators/orelse-operator.md) +- [IsFalse Operator](isfalse-operator.md) +- [How to: Define an Operator](../../programming-guide/language-features/procedures/how-to-define-an-operator.md) +- [OrElse Operator](orelse-operator.md) diff --git a/docs/visual-basic/language-reference/operators/left-shift-assignment-operator.md b/docs/visual-basic/language-reference/operators/left-shift-assignment-operator.md index 628c30a26472e..b0e1a8012f80b 100644 --- a/docs/visual-basic/language-reference/operators/left-shift-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/left-shift-assignment-operator.md @@ -29,14 +29,14 @@ variableorproperty <<= amount Required. Numeric expression of a data type that widens to `Integer`. ## Remarks - The element on the left side of the `<<=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `<<=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `<<=` operator first performs an arithmetic left shift on the value of the variable or property. The operator then assigns the result of that operation back to that variable or property. Arithmetic shifts are not circular, which means the bits shifted off one end of the result are not reintroduced at the other end. In an arithmetic left shift, the bits shifted beyond the range of the result data type are discarded, and the bit positions vacated on the right are set to zero. ## Overloading - The [<< Operator](../../../visual-basic/language-reference/operators/left-shift-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `<<` operator affects the behavior of the `<<=` operator. If your code uses `<<=` on a class or structure that overloads `<<`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [<< Operator](left-shift-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `<<` operator affects the behavior of the `<<=` operator. If your code uses `<<=` on a class or structure that overloads `<<`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `<<=` operator to shift the bit pattern of an `Integer` variable left by the specified amount and assign the result to the variable. @@ -45,9 +45,9 @@ variableorproperty <<= amount ## See also -- [<< Operator](../../../visual-basic/language-reference/operators/left-shift-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Bit Shift Operators](../../../visual-basic/language-reference/operators/bit-shift-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [<< Operator](left-shift-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Bit Shift Operators](bit-shift-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/left-shift-operator.md b/docs/visual-basic/language-reference/operators/left-shift-operator.md index 6c71cc152e464..7fe40cc6ecdeb 100644 --- a/docs/visual-basic/language-reference/operators/left-shift-operator.md +++ b/docs/visual-basic/language-reference/operators/left-shift-operator.md @@ -45,7 +45,7 @@ result = pattern << amount Arithmetic shifts never generate overflow exceptions. > [!NOTE] -> The `<<` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure that you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `<<` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure that you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `<<` operator to perform arithmetic left shifts on integral values. The result always has the same data type as that of the expression being shifted. @@ -68,9 +68,9 @@ result = pattern << amount ## See also -- [Bit Shift Operators](../../../visual-basic/language-reference/operators/bit-shift-operators.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [<<= Operator](../../../visual-basic/language-reference/operators/left-shift-assignment-operator.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [Bit Shift Operators](bit-shift-operators.md) +- [Assignment Operators](assignment-operators.md) +- [<<= Operator](left-shift-assignment-operator.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/like-operator.md b/docs/visual-basic/language-reference/operators/like-operator.md index 1c7899ce18e13..45a76231c2775 100644 --- a/docs/visual-basic/language-reference/operators/like-operator.md +++ b/docs/visual-basic/language-reference/operators/like-operator.md @@ -49,7 +49,7 @@ result = string Like pattern If the value in `string` satisfies the pattern contained in `pattern`, `result` is `True`. If the string does not satisfy the pattern, `result` is `False`. If both `string` and `pattern` are empty strings, the result is `True`. ## Comparison Method - The behavior of the `Like` operator depends on the [Option Compare Statement](../../../visual-basic/language-reference/statements/option-compare-statement.md). The default string comparison method for each source file is `Option Compare Binary`. + The behavior of the `Like` operator depends on the [Option Compare Statement](../statements/option-compare-statement.md). The default string comparison method for each source file is `Option Compare Binary`. ## Pattern Options Built-in pattern matching provides a versatile tool for string comparisons. The pattern-matching features allow you to match each character in `string` against a specific character, a wildcard character, a character list, or a character range. The following table shows the characters allowed in `pattern` and what they match. @@ -70,7 +70,7 @@ result = string Like pattern ## Special Characters To match the special characters left bracket (`[`), question mark (`?`), number sign (`#`), and asterisk (`*`), enclose them in brackets. The right bracket (`]`) cannot be used within a group to match itself, but it can be used outside a group as an individual character. - The character sequence `[]` is considered a zero-length string (`""`). However, it cannot be part of a character list enclosed in brackets. If you want to check whether a position in `string` contains one of a group of characters or no character at all, you can use `Like` twice. For an example, see [How to: Match a String against a Pattern](../../../visual-basic/programming-guide/language-features/operators-and-expressions/how-to-match-a-string-against-a-pattern.md). + The character sequence `[]` is considered a zero-length string (`""`). However, it cannot be part of a character list enclosed in brackets. If you want to check whether a position in `string` contains one of a group of characters or no character at all, you can use `Like` twice. For an example, see [How to: Match a String against a Pattern](../../programming-guide/language-features/operators-and-expressions/how-to-match-a-string-against-a-pattern.md). ## Character Ranges By using a hyphen (`–`) to separate the lower and upper bounds of the range, `charlist` can specify a range of characters. For example, `[A–Z]` results in a match if the corresponding character position in `string` contains any character within the range `A`–`Z`, and `[!H–L]` results in a match if the corresponding character position contains any character outside the range `H`–`L`. @@ -92,7 +92,7 @@ result = string Like pattern When a language that uses a digraph character is specified in the system locale settings, an occurrence of the single digraph character in either `pattern` or `string` matches the equivalent two-character sequence in the other string. Similarly, a digraph character in `pattern` enclosed in brackets (by itself, in a list, or in a range) matches the equivalent two-character sequence in `string`. ## Overloading - The `Like` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `Like` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example This example uses the `Like` operator to compare strings to various patterns. The results go into a `Boolean` variable indicating whether each string satisfies the pattern. @@ -103,9 +103,9 @@ result = string Like pattern - - -- [Comparison Operators](../../../visual-basic/language-reference/operators/comparison-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Option Compare Statement](../../../visual-basic/language-reference/statements/option-compare-statement.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) -- [How to: Match a String against a Pattern](../../../visual-basic/programming-guide/language-features/operators-and-expressions/how-to-match-a-string-against-a-pattern.md) +- [Comparison Operators](comparison-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Option Compare Statement](../statements/option-compare-statement.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) +- [How to: Match a String against a Pattern](../../programming-guide/language-features/operators-and-expressions/how-to-match-a-string-against-a-pattern.md) diff --git a/docs/visual-basic/language-reference/operators/logical-bitwise-operators.md b/docs/visual-basic/language-reference/operators/logical-bitwise-operators.md index 99eb1d27a987f..1847f8d3164ae 100644 --- a/docs/visual-basic/language-reference/operators/logical-bitwise-operators.md +++ b/docs/visual-basic/language-reference/operators/logical-bitwise-operators.md @@ -9,23 +9,23 @@ ms.assetid: 55de4889-7679-4859-8063-bee15abca53f # Logical/Bitwise Operators (Visual Basic) The following are the logical/bitwise operators defined in Visual Basic. - [And Operator](../../../visual-basic/language-reference/operators/and-operator.md) + [And Operator](and-operator.md) - [Not Operator](../../../visual-basic/language-reference/operators/not-operator.md) + [Not Operator](not-operator.md) - [Or Operator](../../../visual-basic/language-reference/operators/or-operator.md) + [Or Operator](or-operator.md) - [Xor Operator](../../../visual-basic/language-reference/operators/xor-operator.md) + [Xor Operator](xor-operator.md) - [AndAlso Operator](../../../visual-basic/language-reference/operators/andalso-operator.md) + [AndAlso Operator](andalso-operator.md) - [OrElse Operator](../../../visual-basic/language-reference/operators/orelse-operator.md) + [OrElse Operator](orelse-operator.md) - [IsFalse Operator](../../../visual-basic/language-reference/operators/isfalse-operator.md) + [IsFalse Operator](isfalse-operator.md) - [IsTrue Operator](../../../visual-basic/language-reference/operators/istrue-operator.md) + [IsTrue Operator](istrue-operator.md) ## See also -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) diff --git a/docs/visual-basic/language-reference/operators/miscellaneous-operators.md b/docs/visual-basic/language-reference/operators/miscellaneous-operators.md index e2c3e0aa04e0f..2f51926279e72 100644 --- a/docs/visual-basic/language-reference/operators/miscellaneous-operators.md +++ b/docs/visual-basic/language-reference/operators/miscellaneous-operators.md @@ -13,18 +13,18 @@ The following are miscellaneous operators defined in Visual Basic. [?() null-conditional operator](null-conditional-operators.md) - [AddressOf operator](../../../visual-basic/language-reference/operators/addressof-operator.md) + [AddressOf operator](addressof-operator.md) - [Await operator](../../../visual-basic/language-reference/operators/await-operator.md) + [Await operator](await-operator.md) - [GetType operator](../../../visual-basic/language-reference/operators/gettype-operator.md) + [GetType operator](gettype-operator.md) - [Function expression](../../../visual-basic/language-reference/operators/function-expression.md) + [Function expression](function-expression.md) - [If operator](../../../visual-basic/language-reference/operators/if-operator.md) + [If operator](if-operator.md) - [TypeOf operator](../../../visual-basic/language-reference/operators/typeof-operator.md) + [TypeOf operator](typeof-operator.md) ## See also -- [Operators listed by functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) +- [Operators listed by functionality](operators-listed-by-functionality.md) diff --git a/docs/visual-basic/language-reference/operators/mod-operator.md b/docs/visual-basic/language-reference/operators/mod-operator.md index da8a4004e017f..9d8f11e052395 100644 --- a/docs/visual-basic/language-reference/operators/mod-operator.md +++ b/docs/visual-basic/language-reference/operators/mod-operator.md @@ -67,13 +67,13 @@ End Module If either `number1` or `number2` is a floating-point value, the floating-point remainder of the division is returned. The data type of the result is the smallest data type that can hold all possible values that result from division with the data types of `number1` and `number2`. -If `number1` or `number2` evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), it is treated as zero. +If `number1` or `number2` evaluates to [Nothing](../nothing.md), it is treated as zero. Related operators include the following: -- The [\ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/integer-division-operator.md) returns the integer quotient of a division. For example, the expression `14 \ 4` evaluates to 3. +- The [\ Operator (Visual Basic)](integer-division-operator.md) returns the integer quotient of a division. For example, the expression `14 \ 4` evaluates to 3. -- The [/ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-operator.md) returns the full quotient, including the remainder, as a floating-point number. For example, the expression `14 / 4` evaluates to 3.5. +- The [/ Operator (Visual Basic)](floating-point-division-operator.md) returns the full quotient, including the remainder, as a floating-point number. For example, the expression `14 / 4` evaluates to 3.5. ## Attempted division by zero @@ -92,11 +92,11 @@ The expression `a Mod b` is equivalent to either of the following formulas: ## Floating-point imprecision -When you work with floating-point numbers, remember that they do not always have a precise decimal representation in memory. This can lead to unexpected results from certain operations, such as value comparison and the `Mod` operator. For more information, see [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md). +When you work with floating-point numbers, remember that they do not always have a precise decimal representation in memory. This can lead to unexpected results from certain operations, such as value comparison and the `Mod` operator. For more information, see [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md). ## Overloading -The `Mod` operator can be *overloaded*, which means that a class or structure can redefine its behavior. If your code applies `Mod` to an instance of a class or structure that includes such an overload, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +The `Mod` operator can be *overloaded*, which means that a class or structure can redefine its behavior. If your code applies `Mod` to an instance of a class or structure that includes such an overload, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example @@ -114,9 +114,9 @@ The following example demonstrates the potential imprecision of floating-point o - - -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Troubleshooting Data Types](../../../visual-basic/programming-guide/language-features/data-types/troubleshooting-data-types.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) -- [\ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/integer-division-operator.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Troubleshooting Data Types](../../programming-guide/language-features/data-types/troubleshooting-data-types.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [\ Operator (Visual Basic)](integer-division-operator.md) diff --git a/docs/visual-basic/language-reference/operators/multiplication-assignment-operator.md b/docs/visual-basic/language-reference/operators/multiplication-assignment-operator.md index 9d6ec9a634fa2..ea68d283a5e2d 100644 --- a/docs/visual-basic/language-reference/operators/multiplication-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/multiplication-assignment-operator.md @@ -28,12 +28,12 @@ variableorproperty *= expression Required. Any numeric expression. ## Remarks - The element on the left side of the `*=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `*=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `*=` operator first multiplies the value of the expression (on the right-hand side of the operator) by the value of the variable or property (on the left-hand side of the operator). The operator then assigns the result of that operation to the variable or property. ## Overloading - The [* Operator](../../../visual-basic/language-reference/operators/multiplication-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `*` operator affects the behavior of the `*=` operator. If your code uses `*=` on a class or structure that overloads `*`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [* Operator](multiplication-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `*` operator affects the behavior of the `*=` operator. If your code uses `*=` on a class or structure that overloads `*`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `*=` operator to multiply one `Integer` variable by a second and assign the result to the first variable. @@ -42,9 +42,9 @@ variableorproperty *= expression ## See also -- [* Operator](../../../visual-basic/language-reference/operators/multiplication-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [* Operator](multiplication-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/multiplication-operator.md b/docs/visual-basic/language-reference/operators/multiplication-operator.md index b22db72ac4f28..c89c857ac140a 100644 --- a/docs/visual-basic/language-reference/operators/multiplication-operator.md +++ b/docs/visual-basic/language-reference/operators/multiplication-operator.md @@ -38,15 +38,15 @@ number1 * number2 |Operand data types|Result data type| |---|---| -|Both expressions are integral data types ([SByte](../../../visual-basic/language-reference/data-types/sbyte-data-type.md), [Byte](../../../visual-basic/language-reference/data-types/byte-data-type.md), [Short](../../../visual-basic/language-reference/data-types/short-data-type.md), [UShort](../../../visual-basic/language-reference/data-types/ushort-data-type.md), [Integer](../../../visual-basic/language-reference/data-types/integer-data-type.md), [UInteger](../../../visual-basic/language-reference/data-types/uinteger-data-type.md), [Long](../../../visual-basic/language-reference/data-types/long-data-type.md), [ULong](../../../visual-basic/language-reference/data-types/ulong-data-type.md))|A numeric data type appropriate for the data types of `number1` and `number2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md).| -|Both expressions are [Decimal](../../../visual-basic/language-reference/data-types/decimal-data-type.md)|`Decimal`| -|Both expressions are [Single](../../../visual-basic/language-reference/data-types/single-data-type.md)|`Single`| -|Either expression is a floating-point data type (`Single` or [Double](../../../visual-basic/language-reference/data-types/double-data-type.md)) but not both `Single` (note `Decimal` is not a floating-point data type)|`Double`| +|Both expressions are integral data types ([SByte](../data-types/sbyte-data-type.md), [Byte](../data-types/byte-data-type.md), [Short](../data-types/short-data-type.md), [UShort](../data-types/ushort-data-type.md), [Integer](../data-types/integer-data-type.md), [UInteger](../data-types/uinteger-data-type.md), [Long](../data-types/long-data-type.md), [ULong](../data-types/ulong-data-type.md))|A numeric data type appropriate for the data types of `number1` and `number2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](data-types-of-operator-results.md).| +|Both expressions are [Decimal](../data-types/decimal-data-type.md)|`Decimal`| +|Both expressions are [Single](../data-types/single-data-type.md)|`Single`| +|Either expression is a floating-point data type (`Single` or [Double](../data-types/double-data-type.md)) but not both `Single` (note `Decimal` is not a floating-point data type)|`Double`| - If an expression evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), it is treated as zero. + If an expression evaluates to [Nothing](../nothing.md), it is treated as zero. ## Overloading - The `*` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `*` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example This example uses the `*` operator to multiply two numbers. The result is the product of the two operands. @@ -55,8 +55,8 @@ number1 * number2 ## See also -- [*= Operator](../../../visual-basic/language-reference/operators/multiplication-assignment-operator.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [*= Operator](multiplication-assignment-operator.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/not-operator.md b/docs/visual-basic/language-reference/operators/not-operator.md index 5c39ab4cd84a4..0d798b8bcf9b8 100644 --- a/docs/visual-basic/language-reference/operators/not-operator.md +++ b/docs/visual-basic/language-reference/operators/not-operator.md @@ -53,7 +53,7 @@ result = Not expression For a Boolean negation, the data type of the result is `Boolean`. For a bitwise negation, the result data type is the same as that of `expression`. However, if expression is `Decimal`, the result is `Long`. ## Overloading - The `Not` operator can be *overloaded*, which means that a class or structure can redefine its behavior when its operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `Not` operator can be *overloaded*, which means that a class or structure can redefine its behavior when its operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `Not` operator to perform logical negation on a `Boolean` expression. The result is a `Boolean` value that represents the reverse of the value of the expression. @@ -71,7 +71,7 @@ result = Not expression ## See also -- [Logical/Bitwise Operators (Visual Basic)](../../../visual-basic/language-reference/operators/logical-bitwise-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [Logical/Bitwise Operators (Visual Basic)](logical-bitwise-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) diff --git a/docs/visual-basic/language-reference/operators/null-conditional-operators.md b/docs/visual-basic/language-reference/operators/null-conditional-operators.md index 251858d277221..f244979e7c822 100644 --- a/docs/visual-basic/language-reference/operators/null-conditional-operators.md +++ b/docs/visual-basic/language-reference/operators/null-conditional-operators.md @@ -107,5 +107,5 @@ The new way is thread-safe because the compiler generates code to evaluate `Send ## See also - [Operators (Visual Basic)](index.md) -- [Visual Basic Programming Guide](../../../visual-basic/programming-guide/index.md) -- [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) +- [Visual Basic Programming Guide](../../programming-guide/index.md) +- [Visual Basic Language Reference](../index.md) diff --git a/docs/visual-basic/language-reference/operators/operator-precedence.md b/docs/visual-basic/language-reference/operators/operator-precedence.md index 62a72e8a6b663..9939257453771 100644 --- a/docs/visual-basic/language-reference/operators/operator-precedence.md +++ b/docs/visual-basic/language-reference/operators/operator-precedence.md @@ -107,11 +107,11 @@ g = (a - (b + c)) / (d * e) ## See also -- [= Operator](../../../visual-basic/language-reference/operators/assignment-operator.md) -- [Is Operator](../../../visual-basic/language-reference/operators/is-operator.md) -- [IsNot Operator](../../../visual-basic/language-reference/operators/isnot-operator.md) -- [Like Operator](../../../visual-basic/language-reference/operators/like-operator.md) -- [TypeOf Operator](../../../visual-basic/language-reference/operators/typeof-operator.md) -- [Await Operator](../../../visual-basic/language-reference/operators/await-operator.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) +- [= Operator](assignment-operator.md) +- [Is Operator](is-operator.md) +- [IsNot Operator](isnot-operator.md) +- [Like Operator](like-operator.md) +- [TypeOf Operator](typeof-operator.md) +- [Await Operator](await-operator.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) diff --git a/docs/visual-basic/language-reference/operators/operators-listed-by-functionality.md b/docs/visual-basic/language-reference/operators/operators-listed-by-functionality.md index 3b9ec515df4eb..8d37efb2af272 100644 --- a/docs/visual-basic/language-reference/operators/operators-listed-by-functionality.md +++ b/docs/visual-basic/language-reference/operators/operators-listed-by-functionality.md @@ -12,15 +12,15 @@ See one of the categories listed below, or open this portion of the Help table o |Operators|Description| |---------------|-----------------| -|[Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md)|These operators perform mathematical calculations.| -|[Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md)|These operators perform assignment operations.| -|[Comparison Operators](../../../visual-basic/language-reference/operators/comparison-operators.md)|These operators perform comparisons.| -|[Concatenation Operators](../../../visual-basic/language-reference/operators/concatenation-operators.md)|These operators combine strings.| -|[Logical/Bitwise Operators](../../../visual-basic/language-reference/operators/logical-bitwise-operators.md)|These operators perform logical operations.| -|[Bit Shift Operators](../../../visual-basic/language-reference/operators/bit-shift-operators.md)|These operators perform arithmetic shifts on bit patterns.| -|[Miscellaneous Operators](../../../visual-basic/language-reference/operators/miscellaneous-operators.md)|These operators perform miscellaneous operations.| +|[Arithmetic Operators](arithmetic-operators.md)|These operators perform mathematical calculations.| +|[Assignment Operators](assignment-operators.md)|These operators perform assignment operations.| +|[Comparison Operators](comparison-operators.md)|These operators perform comparisons.| +|[Concatenation Operators](concatenation-operators.md)|These operators combine strings.| +|[Logical/Bitwise Operators](logical-bitwise-operators.md)|These operators perform logical operations.| +|[Bit Shift Operators](bit-shift-operators.md)|These operators perform arithmetic shifts on bit patterns.| +|[Miscellaneous Operators](miscellaneous-operators.md)|These operators perform miscellaneous operations.| ## See also -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) diff --git a/docs/visual-basic/language-reference/operators/or-operator.md b/docs/visual-basic/language-reference/operators/or-operator.md index e78ce087c1714..8debbb5f79efe 100644 --- a/docs/visual-basic/language-reference/operators/or-operator.md +++ b/docs/visual-basic/language-reference/operators/or-operator.md @@ -46,7 +46,7 @@ result = expression1 Or expression2 |`False`|`False`|`False`| > [!NOTE] -> In a `Boolean` comparison, the `Or` operator always evaluates both expressions, which could include making procedure calls. The [OrElse Operator](../../../visual-basic/language-reference/operators/orelse-operator.md) performs *short-circuiting*, which means that if `expression1` is `True`, then `expression2` is not evaluated. +> In a `Boolean` comparison, the `Or` operator always evaluates both expressions, which could include making procedure calls. The [OrElse Operator](orelse-operator.md) performs *short-circuiting*, which means that if `expression1` is `True`, then `expression2` is not evaluated. For bitwise operations, the `Or` operator performs a bitwise comparison of identically positioned bits in two numeric expressions and sets the corresponding bit in `result` according to the following table. @@ -63,10 +63,10 @@ result = expression1 Or expression2 ## Data Types If the operands consist of one `Boolean` expression and one numeric expression, Visual Basic converts the `Boolean` expression to a numeric value (–1 for `True` and 0 for `False`) and performs a bitwise operation. - For a `Boolean` comparison, the data type of the result is `Boolean`. For a bitwise comparison, the result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Relational and Bitwise Comparisons" table in [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md). + For a `Boolean` comparison, the data type of the result is `Boolean`. For a bitwise comparison, the result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Relational and Bitwise Comparisons" table in [Data Types of Operator Results](data-types-of-operator-results.md). ## Overloading - The `Or` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `Or` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `Or` operator to perform an inclusive logical disjunction on two expressions. The result is a `Boolean` value that represents whether either of the two expressions is `True`. @@ -84,8 +84,8 @@ result = expression1 Or expression2 ## See also -- [Logical/Bitwise Operators (Visual Basic)](../../../visual-basic/language-reference/operators/logical-bitwise-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [OrElse Operator](../../../visual-basic/language-reference/operators/orelse-operator.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [Logical/Bitwise Operators (Visual Basic)](logical-bitwise-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [OrElse Operator](orelse-operator.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) diff --git a/docs/visual-basic/language-reference/operators/orelse-operator.md b/docs/visual-basic/language-reference/operators/orelse-operator.md index 82083a3f28bfd..48f974e0f691b 100644 --- a/docs/visual-basic/language-reference/operators/orelse-operator.md +++ b/docs/visual-basic/language-reference/operators/orelse-operator.md @@ -43,11 +43,11 @@ result = expression1 OrElse expression2 |`False`|`False`|`False`| ## Data Types - The `OrElse` operator is defined only for the [Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md). Visual Basic converts each operand as necessary to `Boolean` before evaluating the expression. If you assign the result to a numeric type, Visual Basic converts it from `Boolean` to that type such that `False` becomes `0` and `True` becomes `-1`. + The `OrElse` operator is defined only for the [Boolean Data Type](../data-types/boolean-data-type.md). Visual Basic converts each operand as necessary to `Boolean` before evaluating the expression. If you assign the result to a numeric type, Visual Basic converts it from `Boolean` to that type such that `False` becomes `0` and `True` becomes `-1`. For more information, see [Boolean Type Conversions](../data-types/boolean-data-type.md#type-conversions). ## Overloading - The [Or Operator](../../../visual-basic/language-reference/operators/or-operator.md) and the [IsTrue Operator](../../../visual-basic/language-reference/operators/istrue-operator.md) can be *overloaded*, which means that a class or structure can redefine their behavior when an operand has the type of that class or structure. Overloading the `Or` and `IsTrue` operators affects the behavior of the `OrElse` operator. If your code uses `OrElse` on a class or structure that overloads `Or` and `IsTrue`, be sure you understand their redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [Or Operator](or-operator.md) and the [IsTrue Operator](istrue-operator.md) can be *overloaded*, which means that a class or structure can redefine their behavior when an operand has the type of that class or structure. Overloading the `Or` and `IsTrue` operators affects the behavior of the `OrElse` operator. If your code uses `OrElse` on a class or structure that overloads `Or` and `IsTrue`, be sure you understand their redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `OrElse` operator to perform logical disjunction on two expressions. The result is a `Boolean` value that represents whether either of the two expressions is true. If the first expression is `True`, the second is not evaluated. @@ -63,9 +63,9 @@ For more information, see [Boolean Type Conversions](../data-types/boolean-data- ## See also -- [Logical/Bitwise Operators (Visual Basic)](../../../visual-basic/language-reference/operators/logical-bitwise-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Or Operator](../../../visual-basic/language-reference/operators/or-operator.md) -- [IsTrue Operator](../../../visual-basic/language-reference/operators/istrue-operator.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [Logical/Bitwise Operators (Visual Basic)](logical-bitwise-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Or Operator](or-operator.md) +- [IsTrue Operator](istrue-operator.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) diff --git a/docs/visual-basic/language-reference/operators/right-shift-assignment-operator.md b/docs/visual-basic/language-reference/operators/right-shift-assignment-operator.md index daaceb049af1c..2d0391ae9968d 100644 --- a/docs/visual-basic/language-reference/operators/right-shift-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/right-shift-assignment-operator.md @@ -28,14 +28,14 @@ variableorproperty >>= amount Required. Numeric expression of a data type that widens to `Integer`. ## Remarks - The element on the left side of the `>>=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `>>=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `>>=` operator first performs an arithmetic right shift on the value of the variable or property. The operator then assigns the result of that operation back to the variable or property. Arithmetic shifts are not circular, which means the bits shifted off one end of the result are not reintroduced at the other end. In an arithmetic right shift, the bits shifted beyond the rightmost bit position are discarded, and the leftmost bit is propagated into the bit positions vacated at the left. This means that if `variableorproperty` has a negative value, the vacated positions are set to one. If `variableorproperty` is positive, or if its data type is an unsigned type, the vacated positions are set to zero. ## Overloading - The [>> Operator](../../../visual-basic/language-reference/operators/right-shift-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `>>` operator affects the behavior of the `>>=` operator. If your code uses `>>=` on a class or structure that overloads `>>`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [>> Operator](right-shift-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `>>` operator affects the behavior of the `>>=` operator. If your code uses `>>=` on a class or structure that overloads `>>`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `>>=` operator to shift the bit pattern of an `Integer` variable right by the specified amount and assign the result to the variable. @@ -44,9 +44,9 @@ variableorproperty >>= amount ## See also -- [>> Operator](../../../visual-basic/language-reference/operators/right-shift-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Bit Shift Operators](../../../visual-basic/language-reference/operators/bit-shift-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [>> Operator](right-shift-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Bit Shift Operators](bit-shift-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/right-shift-operator.md b/docs/visual-basic/language-reference/operators/right-shift-operator.md index 83786c2d53597..b6de6cea36e62 100644 --- a/docs/visual-basic/language-reference/operators/right-shift-operator.md +++ b/docs/visual-basic/language-reference/operators/right-shift-operator.md @@ -49,7 +49,7 @@ result = pattern >> amount Arithmetic shifts never generate overflow exceptions. ## Overloading - The `>>` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `>>` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `>>` operator to perform arithmetic right shifts on integral values. The result always has the same data type as that of the expression being shifted. @@ -82,9 +82,9 @@ result = pattern >> amount ## See also -- [Bit Shift Operators](../../../visual-basic/language-reference/operators/bit-shift-operators.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [>>= Operator](../../../visual-basic/language-reference/operators/right-shift-assignment-operator.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [Bit Shift Operators](bit-shift-operators.md) +- [Assignment Operators](assignment-operators.md) +- [>>= Operator](right-shift-assignment-operator.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/sub-expression.md b/docs/visual-basic/language-reference/operators/sub-expression.md index ebcb1a2d88002..fae2433a62e92 100644 --- a/docs/visual-basic/language-reference/operators/sub-expression.md +++ b/docs/visual-basic/language-reference/operators/sub-expression.md @@ -24,12 +24,12 @@ End Sub |Term|Definition| |---|---| -|`parameterlist`|Optional. A list of local variable names that represent the parameters of the procedure. The parentheses must be present even when the list is empty. For more information, see [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md).| +|`parameterlist`|Optional. A list of local variable names that represent the parameters of the procedure. The parentheses must be present even when the list is empty. For more information, see [Parameter List](../statements/parameter-list.md).| |`statement`|Required. A single statement.| |`statements`|Required. A list of statements.| ## Remarks - A *lambda expression* is a subroutine that does not have a name and that executes one or more statements. You can use a lambda expression anywhere that you can use a delegate type, except as an argument to `RemoveHandler`. For more information about delegates, and the use of lambda expressions with delegates, see [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) and [Relaxed Delegate Conversion](../../../visual-basic/programming-guide/language-features/delegates/relaxed-delegate-conversion.md). + A *lambda expression* is a subroutine that does not have a name and that executes one or more statements. You can use a lambda expression anywhere that you can use a delegate type, except as an argument to `RemoveHandler`. For more information about delegates, and the use of lambda expressions with delegates, see [Delegate Statement](../statements/delegate-statement.md) and [Relaxed Delegate Conversion](../../programming-guide/language-features/delegates/relaxed-delegate-conversion.md). ## Lambda Expression Syntax The syntax of a lambda expression resembles that of a standard subroutine. The differences are as follows: @@ -47,14 +47,14 @@ End Sub - Generic parameters are not permitted in lambda expressions. ## Example - Following is an example of a lambda expression that writes a value to the console. The example shows both the single-line and multiline lambda expression syntax for a subroutine. For more examples, see [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md). + Following is an example of a lambda expression that writes a value to the console. The example shows both the single-line and multiline lambda expression syntax for a subroutine. For more examples, see [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md). [!code-vb[VbVbalrLambdas#15](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrLambdas/VB/Class1.vb#15)] ## See also -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) -- [Relaxed Delegate Conversion](../../../visual-basic/programming-guide/language-features/delegates/relaxed-delegate-conversion.md) +- [Sub Statement](../statements/sub-statement.md) +- [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) +- [Statements](../../programming-guide/language-features/statements.md) +- [Relaxed Delegate Conversion](../../programming-guide/language-features/delegates/relaxed-delegate-conversion.md) diff --git a/docs/visual-basic/language-reference/operators/subtraction-assignment-operator.md b/docs/visual-basic/language-reference/operators/subtraction-assignment-operator.md index 87af2d5188827..a982c2911c32c 100644 --- a/docs/visual-basic/language-reference/operators/subtraction-assignment-operator.md +++ b/docs/visual-basic/language-reference/operators/subtraction-assignment-operator.md @@ -28,12 +28,12 @@ variableorproperty -= expression Required. Any numeric expression. ## Remarks - The element on the left side of the `-=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md). + The element on the left side of the `-=` operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be [ReadOnly](../modifiers/readonly.md). The `-=` operator first subtracts the value of the expression (on the right-hand side of the operator) from the value of the variable or property (on the left-hand side of the operator). The operator then assigns the result of that operation to the variable or property. ## Overloading - The [- Operator (Visual Basic)](../../../visual-basic/language-reference/operators/subtraction-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `-` operator affects the behavior of the `-=` operator. If your code uses `-=` on a class or structure that overloads `-`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The [- Operator (Visual Basic)](subtraction-operator.md) can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the `-` operator affects the behavior of the `-=` operator. If your code uses `-=` on a class or structure that overloads `-`, be sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `-=` operator to subtract one `Integer` variable from another and assign the result to the latter variable. @@ -42,9 +42,9 @@ variableorproperty -= expression ## See also -- [- Operator (Visual Basic)](../../../visual-basic/language-reference/operators/subtraction-operator.md) -- [Assignment Operators](../../../visual-basic/language-reference/operators/assignment-operators.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Statements](../../../visual-basic/programming-guide/language-features/statements.md) +- [- Operator (Visual Basic)](subtraction-operator.md) +- [Assignment Operators](assignment-operators.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Statements](../../programming-guide/language-features/statements.md) diff --git a/docs/visual-basic/language-reference/operators/subtraction-operator.md b/docs/visual-basic/language-reference/operators/subtraction-operator.md index 9985fa112de34..982a700635879 100644 --- a/docs/visual-basic/language-reference/operators/subtraction-operator.md +++ b/docs/visual-basic/language-reference/operators/subtraction-operator.md @@ -43,7 +43,7 @@ or ## Result The result is the difference between `expression1` and `expression2`, or the negated value of `expression1`. - The result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md). + The result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Integer Arithmetic" tables in [Data Types of Operator Results](data-types-of-operator-results.md). ## Supported Types All numeric types. This includes the unsigned and floating-point types and `Decimal`. @@ -53,10 +53,10 @@ or In the second usage shown in the syntax shown previously, the `–` operator is the *unary* negation operator for the negative value of an expression. In this sense, the negation consists of reversing the sign of `expression1` so that the result is positive if `expression1` is negative. - If either expression evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), the `–` operator treats it as zero. + If either expression evaluates to [Nothing](../nothing.md), the `–` operator treats it as zero. > [!NOTE] -> The `–` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, make sure that you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). +> The `–` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, make sure that you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `–` operator to calculate and return the difference between two numbers, and then to negate a number. @@ -67,8 +67,8 @@ or ## See also -- [-= Operator (Visual Basic)](../../../visual-basic/language-reference/operators/subtraction-assignment-operator.md) -- [Arithmetic Operators](../../../visual-basic/language-reference/operators/arithmetic-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Arithmetic Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) +- [-= Operator (Visual Basic)](subtraction-assignment-operator.md) +- [Arithmetic Operators](arithmetic-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Arithmetic Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/arithmetic-operators.md) diff --git a/docs/visual-basic/language-reference/operators/trycast-operator.md b/docs/visual-basic/language-reference/operators/trycast-operator.md index 5e1198996223c..815ef42d0b16a 100644 --- a/docs/visual-basic/language-reference/operators/trycast-operator.md +++ b/docs/visual-basic/language-reference/operators/trycast-operator.md @@ -12,21 +12,21 @@ ms.assetid: d1ef5d47-fef4-491e-b014-1d910628f65c Introduces a type conversion operation that does not throw an exception. ## Remarks - If an attempted conversion fails, `CType` and `DirectCast` both throw an error. This can adversely affect the performance of your application. `TryCast` returns [Nothing](../../../visual-basic/language-reference/nothing.md), so that instead of having to handle a possible exception, you need only test the returned result against `Nothing`. + If an attempted conversion fails, `CType` and `DirectCast` both throw an error. This can adversely affect the performance of your application. `TryCast` returns [Nothing](../nothing.md), so that instead of having to handle a possible exception, you need only test the returned result against `Nothing`. - You use the `TryCast` keyword the same way you use the [CType Function](../../../visual-basic/language-reference/functions/ctype-function.md) and the [DirectCast Operator](../../../visual-basic/language-reference/operators/directcast-operator.md) keyword. You supply an expression as the first argument and a type to convert it to as the second argument. `TryCast` operates only on reference types, such as classes and interfaces. It requires an inheritance or implementation relationship between the two types. This means that one type must inherit from or implement the other. + You use the `TryCast` keyword the same way you use the [CType Function](../functions/ctype-function.md) and the [DirectCast Operator](directcast-operator.md) keyword. You supply an expression as the first argument and a type to convert it to as the second argument. `TryCast` operates only on reference types, such as classes and interfaces. It requires an inheritance or implementation relationship between the two types. This means that one type must inherit from or implement the other. ## Errors and Failures - `TryCast` generates a compiler error if it detects that no inheritance or implementation relationship exists. But the lack of a compiler error does not guarantee a successful conversion. If the desired conversion is narrowing, it could fail at run time. If this happens, `TryCast` returns [Nothing](../../../visual-basic/language-reference/nothing.md). + `TryCast` generates a compiler error if it detects that no inheritance or implementation relationship exists. But the lack of a compiler error does not guarantee a successful conversion. If the desired conversion is narrowing, it could fail at run time. If this happens, `TryCast` returns [Nothing](../nothing.md). ## Conversion Keywords A comparison of the type conversion keywords is as follows. |Keyword|Data types|Argument relationship|Run-time failure| |---|---|---|---| -|[CType Function](../../../visual-basic/language-reference/functions/ctype-function.md)|Any data types|Widening or narrowing conversion must be defined between the two data types|Throws | -|[DirectCast Operator](../../../visual-basic/language-reference/operators/directcast-operator.md)|Any data types|One type must inherit from or implement the other type|Throws | -|`TryCast`|Reference types only|One type must inherit from or implement the other type|Returns [Nothing](../../../visual-basic/language-reference/nothing.md)| +|[CType Function](../functions/ctype-function.md)|Any data types|Widening or narrowing conversion must be defined between the two data types|Throws | +|[DirectCast Operator](directcast-operator.md)|Any data types|One type must inherit from or implement the other type|Throws | +|`TryCast`|Reference types only|One type must inherit from or implement the other type|Returns [Nothing](../nothing.md)| ## Example The following example shows how to use `TryCast`. @@ -35,5 +35,5 @@ Introduces a type conversion operation that does not throw an exception. ## See also -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) diff --git a/docs/visual-basic/language-reference/operators/typeof-operator.md b/docs/visual-basic/language-reference/operators/typeof-operator.md index 597e1a0018c1a..e22b1947f0686 100644 --- a/docs/visual-basic/language-reference/operators/typeof-operator.md +++ b/docs/visual-basic/language-reference/operators/typeof-operator.md @@ -58,9 +58,9 @@ result = TypeOf objectexpression IsNot typename ## See also -- [Is Operator](../../../visual-basic/language-reference/operators/is-operator.md) -- [IsNot Operator](../../../visual-basic/language-reference/operators/isnot-operator.md) -- [Comparison Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/comparison-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Operators and Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/index.md) +- [Is Operator](is-operator.md) +- [IsNot Operator](isnot-operator.md) +- [Comparison Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/comparison-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Operators and Expressions](../../programming-guide/language-features/operators-and-expressions/index.md) diff --git a/docs/visual-basic/language-reference/operators/xor-operator.md b/docs/visual-basic/language-reference/operators/xor-operator.md index fd2f983c0d319..1765ec0818c14 100644 --- a/docs/visual-basic/language-reference/operators/xor-operator.md +++ b/docs/visual-basic/language-reference/operators/xor-operator.md @@ -45,7 +45,7 @@ result = expression1 Xor expression2 |`False`|`False`|`False`| > [!NOTE] -> In a Boolean comparison, the `Xor` operator always evaluates both expressions, which could include making procedure calls. There is no short-circuiting counterpart to `Xor`, because the result always depends on both operands. For *short-circuiting* logical operators, see [AndAlso Operator](../../../visual-basic/language-reference/operators/andalso-operator.md) and [OrElse Operator](../../../visual-basic/language-reference/operators/orelse-operator.md). +> In a Boolean comparison, the `Xor` operator always evaluates both expressions, which could include making procedure calls. There is no short-circuiting counterpart to `Xor`, because the result always depends on both operands. For *short-circuiting* logical operators, see [AndAlso Operator](andalso-operator.md) and [OrElse Operator](orelse-operator.md). For bitwise operations, the `Xor` operator performs a bitwise comparison of identically positioned bits in two numeric expressions and sets the corresponding bit in `result` according to the following table. @@ -64,10 +64,10 @@ result = expression1 Xor expression2 ## Data Types If the operands consist of one `Boolean` expression and one numeric expression, Visual Basic converts the `Boolean` expression to a numeric value (–1 for `True` and 0 for `False`) and performs a bitwise operation. - For a `Boolean` comparison, the data type of the result is `Boolean`. For a bitwise comparison, the result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Relational and Bitwise Comparisons" table in [Data Types of Operator Results](../../../visual-basic/language-reference/operators/data-types-of-operator-results.md). + For a `Boolean` comparison, the data type of the result is `Boolean`. For a bitwise comparison, the result data type is a numeric type appropriate for the data types of `expression1` and `expression2`. See the "Relational and Bitwise Comparisons" table in [Data Types of Operator Results](data-types-of-operator-results.md). ## Overloading - The `Xor` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, make sure you understand its redefined behavior. For more information, see [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md). + The `Xor` operator can be *overloaded*, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. If your code uses this operator on such a class or structure, make sure you understand its redefined behavior. For more information, see [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md). ## Example The following example uses the `Xor` operator to perform logical exclusion (exclusive logical disjunction) on two expressions. The result is a `Boolean` value that represents whether exactly one of the expressions is `True`. @@ -85,7 +85,7 @@ result = expression1 Xor expression2 ## See also -- [Logical/Bitwise Operators (Visual Basic)](../../../visual-basic/language-reference/operators/logical-bitwise-operators.md) -- [Operator Precedence in Visual Basic](../../../visual-basic/language-reference/operators/operator-precedence.md) -- [Operators Listed by Functionality](../../../visual-basic/language-reference/operators/operators-listed-by-functionality.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [Logical/Bitwise Operators (Visual Basic)](logical-bitwise-operators.md) +- [Operator Precedence in Visual Basic](operator-precedence.md) +- [Operators Listed by Functionality](operators-listed-by-functionality.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) diff --git a/docs/visual-basic/language-reference/properties.md b/docs/visual-basic/language-reference/properties.md index b0fe3f6482268..c13a4fc079fed 100644 --- a/docs/visual-basic/language-reference/properties.md +++ b/docs/visual-basic/language-reference/properties.md @@ -7,7 +7,7 @@ ms.assetid: c995caf9-8d0e-4fb8-ae02-e9e6087d7651 --- # Properties (Visual Basic) -This page lists the properties that are members of Visual Basic modules. Other properties that are members of specific Visual Basic objects are listed in [Objects](../../visual-basic/language-reference/objects/index.md). +This page lists the properties that are members of Visual Basic modules. Other properties that are members of specific Visual Basic objects are listed in [Objects](objects/index.md). ## Visual Basic Properties @@ -26,4 +26,4 @@ This page lists the properties that are members of Visual Basic modules. Other p ## See also -- [Visual Basic Language Reference](../../visual-basic/language-reference/index.md) +- [Visual Basic Language Reference](index.md) diff --git a/docs/visual-basic/language-reference/queries/aggregate-clause.md b/docs/visual-basic/language-reference/queries/aggregate-clause.md index 4c101b678b908..db338e1bd5660 100644 --- a/docs/visual-basic/language-reference/queries/aggregate-clause.md +++ b/docs/visual-basic/language-reference/queries/aggregate-clause.md @@ -70,7 +70,7 @@ Counts the number of elements in the collection. You can supply an optional `Boo ### Group -Refers to query results that are grouped as a result of a `Group By` or `Group Join` clause. The `Group` function is valid only in the `Into` clause of a `Group By` or `Group Join` clause. For more information and examples, see [Group By Clause](../../../visual-basic/language-reference/queries/group-by-clause.md) and [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md). +Refers to query results that are grouped as a result of a `Group By` or `Group Join` clause. The `Group` function is valid only in the `Into` clause of a `Group By` or `Group Join` clause. For more information and examples, see [Group By Clause](group-by-clause.md) and [Group Join Clause](group-join-clause.md). ### LongCount @@ -102,9 +102,9 @@ The following example shows how to use the `Aggregate` clause to apply aggregate ## Creating User-Defined Aggregate Functions - You can include your own custom aggregate functions in a query expression by adding extension methods to the type. Your custom method can then perform a calculation or operation on the enumerable collection that has referenced your aggregate function. For more information about extension methods, see [Extension Methods](../../../visual-basic/programming-guide/language-features/procedures/extension-methods.md). + You can include your own custom aggregate functions in a query expression by adding extension methods to the type. Your custom method can then perform a calculation or operation on the enumerable collection that has referenced your aggregate function. For more information about extension methods, see [Extension Methods](../../programming-guide/language-features/procedures/extension-methods.md). - For example, the following example shows a custom aggregate function that calculates the median value of a collection of numbers. There are two overloads of the `Median` extension method. The first overload accepts, as input, a collection of type `IEnumerable(Of Double)`. If the `Median` aggregate function is called for a query field of type `Double`, this method will be called. The second overload of the `Median` method can be passed any generic type. The generic overload of the `Median` method takes a second parameter that references the `Func(Of T, Double)` lambda expression to project a value for a type (from a collection) as the corresponding value of type `Double`. It then delegates the calculation of the median value to the other overload of the `Median` method. For more information about lambda expressions, see [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md). + For example, the following example shows a custom aggregate function that calculates the median value of a collection of numbers. There are two overloads of the `Median` extension method. The first overload accepts, as input, a collection of type `IEnumerable(Of Double)`. If the `Median` aggregate function is called for a query field of type `Double`, this method will be called. The second overload of the `Median` method can be passed any generic type. The generic overload of the `Median` method takes a second parameter that references the `Func(Of T, Double)` lambda expression to project a value for a type (from a collection) as the corresponding value of type `Double`. It then delegates the calculation of the median value to the other overload of the `Median` method. For more information about lambda expressions, see [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md). [!code-vb[VbSimpleQuerySamples#18](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbSimpleQuerySamples/VB/UserDefinedAggregates.vb#18)] @@ -114,9 +114,9 @@ The following example shows how to use the `Aggregate` clause to apply aggregate ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) -- [Group By Clause](../../../visual-basic/language-reference/queries/group-by-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Where Clause](where-clause.md) +- [Group By Clause](group-by-clause.md) diff --git a/docs/visual-basic/language-reference/queries/distinct-clause.md b/docs/visual-basic/language-reference/queries/distinct-clause.md index 5513af40201bc..242ff5611757c 100644 --- a/docs/visual-basic/language-reference/queries/distinct-clause.md +++ b/docs/visual-basic/language-reference/queries/distinct-clause.md @@ -28,8 +28,8 @@ Distinct ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [From Clause](from-clause.md) +- [Select Clause](select-clause.md) +- [Where Clause](where-clause.md) diff --git a/docs/visual-basic/language-reference/queries/equals-clause.md b/docs/visual-basic/language-reference/queries/equals-clause.md index 695e41e10cba3..b52c321f89645 100644 --- a/docs/visual-basic/language-reference/queries/equals-clause.md +++ b/docs/visual-basic/language-reference/queries/equals-clause.md @@ -13,10 +13,10 @@ Compares keys from collections being joined. ## Remarks The `Equals` keyword is used in the following contexts: - [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) + [Group Join Clause](group-join-clause.md) - [Join Clause](../../../visual-basic/language-reference/queries/join-clause.md) + [Join Clause](join-clause.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/queries/from-clause.md b/docs/visual-basic/language-reference/queries/from-clause.md index 6ac642f107987..d03979f6467fc 100644 --- a/docs/visual-basic/language-reference/queries/from-clause.md +++ b/docs/visual-basic/language-reference/queries/from-clause.md @@ -30,7 +30,7 @@ From element [ As type ] In collection [ _ ] |`collection`|Required. Refers to the collection to be queried. Must be an enumerable type.| ## Remarks - The `From` clause is used to identify the source data for a query and the variables that are used to refer to an element from the source collection. These variables are called *range variables*. The `From` clause is required for a query, except when the `Aggregate` clause is used to identify a query that returns only aggregated results. For more information, see [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md). + The `From` clause is used to identify the source data for a query and the variables that are used to refer to an element from the source collection. These variables are called *range variables*. The `From` clause is required for a query, except when the `Aggregate` clause is used to identify a query that returns only aggregated results. For more information, see [Aggregate Clause](aggregate-clause.md). You can specify multiple `From` clauses in a query to identify multiple collections to be joined. When multiple collections are specified, they are iterated over independently, or you can join them if they are related. You can join collections implicitly by using the `Select` clause, or explicitly by using the `Join` or `Group Join` clauses. As an alternative, you can specify multiple range variables and collections in a single `From` clause, with each related range variable and collection separated from the others by a comma. The following code example shows both syntax options for the `From` clause. @@ -65,19 +65,19 @@ From element [ As type ] In collection [ _ ] ## See also -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md) -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) -- [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md) -- [Distinct Clause](../../../visual-basic/language-reference/queries/distinct-clause.md) -- [Join Clause](../../../visual-basic/language-reference/queries/join-clause.md) -- [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) -- [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md) -- [Let Clause](../../../visual-basic/language-reference/queries/let-clause.md) -- [Skip Clause](../../../visual-basic/language-reference/queries/skip-clause.md) -- [Take Clause](../../../visual-basic/language-reference/queries/take-clause.md) -- [Skip While Clause](../../../visual-basic/language-reference/queries/skip-while-clause.md) -- [Take While Clause](../../../visual-basic/language-reference/queries/take-while-clause.md) +- [Queries](index.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [For Each...Next Statement](../statements/for-each-next-statement.md) +- [For...Next Statement](../statements/for-next-statement.md) +- [Select Clause](select-clause.md) +- [Where Clause](where-clause.md) +- [Aggregate Clause](aggregate-clause.md) +- [Distinct Clause](distinct-clause.md) +- [Join Clause](join-clause.md) +- [Group Join Clause](group-join-clause.md) +- [Order By Clause](order-by-clause.md) +- [Let Clause](let-clause.md) +- [Skip Clause](skip-clause.md) +- [Take Clause](take-clause.md) +- [Skip While Clause](skip-while-clause.md) +- [Take While Clause](take-while-clause.md) diff --git a/docs/visual-basic/language-reference/queries/group-by-clause.md b/docs/visual-basic/language-reference/queries/group-by-clause.md index 16029a92a5998..8e8cab35fb6ed 100644 --- a/docs/visual-basic/language-reference/queries/group-by-clause.md +++ b/docs/visual-basic/language-reference/queries/group-by-clause.md @@ -56,7 +56,7 @@ Group [ listField1 [, listField2 [...] ] By keyExp1 [, keyExp2 [...] ] ## Remarks You can use the `Group By` clause to break the results of a query into groups. The grouping is based on a key or a composite key consisting of multiple keys. Elements that are associated with matching key values are included in the same group. - You use the `aggregateList` parameter of the `Into` clause and the `Group` keyword to identify the member name that is used to reference the group. You can also include aggregate functions in the `Into` clause to compute values for the grouped elements. For a list of standard aggregate functions, see [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md). + You use the `aggregateList` parameter of the `Into` clause and the `Group` keyword to identify the member name that is used to reference the group. You can also include aggregate functions in the `Into` clause to compute values for the grouped elements. For a list of standard aggregate functions, see [Aggregate Clause](aggregate-clause.md). ## Example The following code example groups a list of customers based on their location (country/region) and provides a count of the customers in each group. The results are ordered by country/region name. The grouped results are ordered by city name. @@ -65,10 +65,10 @@ Group [ listField1 [, listField2 [...] ] By keyExp1 [, keyExp2 [...] ] ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md) -- [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md) -- [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Order By Clause](order-by-clause.md) +- [Aggregate Clause](aggregate-clause.md) +- [Group Join Clause](group-join-clause.md) diff --git a/docs/visual-basic/language-reference/queries/group-join-clause.md b/docs/visual-basic/language-reference/queries/group-join-clause.md index 483c3e29f9aac..574deea7ec3a4 100644 --- a/docs/visual-basic/language-reference/queries/group-join-clause.md +++ b/docs/visual-basic/language-reference/queries/group-join-clause.md @@ -34,11 +34,11 @@ Group Join element [As type] In collection _ |`expressionList`|Required. One or more expressions that identify how the groups of elements from the collection are aggregated. To identify a member name for the grouped results, use the `Group` keyword (` = Group`). You can also include aggregate functions to apply to the group.| ## Remarks - The `Group Join` clause combines two collections based on matching key values from the collections being joined. The resulting collection can contain a member that references a collection of elements from the second collection that match the key value from the first collection. You can also specify aggregate functions to apply to the grouped elements from the second collection. For information about aggregate functions, see [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md). + The `Group Join` clause combines two collections based on matching key values from the collections being joined. The resulting collection can contain a member that references a collection of elements from the second collection that match the key value from the first collection. You can also specify aggregate functions to apply to the grouped elements from the second collection. For information about aggregate functions, see [Aggregate Clause](aggregate-clause.md). Consider, for example, a collection of managers and a collection of employees. Elements from both collections have a ManagerID property that identifies the employees that report to a particular manager. The results from a join operation would contain a result for each manager and employee with a matching ManagerID value. The results from a `Group Join` operation would contain the complete list of managers. Each manager result would have a member that referenced the list of employees that were a match for the specific manager. - The collection resulting from a `Group Join` operation can contain any combination of values from the collection identified in the `From` clause and the expressions identified in the `Into` clause of the `Group Join` clause. For more information about valid expressions for the `Into` clause, see [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md). + The collection resulting from a `Group Join` operation can contain any combination of values from the collection identified in the `From` clause and the expressions identified in the `Into` clause of the `Group Join` clause. For more information about valid expressions for the `Into` clause, see [Aggregate Clause](aggregate-clause.md). A `Group Join` operation will return all results from the collection identified on the left side of the `Group Join` operator. This is true even if there are no matches in the collection being joined. This is like a `LEFT OUTER JOIN` in SQL. @@ -51,10 +51,10 @@ Group Join element [As type] In collection _ ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Join Clause](../../../visual-basic/language-reference/queries/join-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) -- [Group By Clause](../../../visual-basic/language-reference/queries/group-by-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Join Clause](join-clause.md) +- [Where Clause](where-clause.md) +- [Group By Clause](group-by-clause.md) diff --git a/docs/visual-basic/language-reference/queries/index.md b/docs/visual-basic/language-reference/queries/index.md index c61a67e99c351..df0e66811ca71 100644 --- a/docs/visual-basic/language-reference/queries/index.md +++ b/docs/visual-basic/language-reference/queries/index.md @@ -10,49 +10,49 @@ ms.assetid: 8edc717c-4a24-4cbc-9c16-11f479c935db Visual Basic enables you to create Language-Integrated Query (LINQ) expressions in your code. ## In This Section - [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md) + [Aggregate Clause](aggregate-clause.md) Describes the `Aggregate` clause, which applies one or more aggregate functions to a collection. - [Distinct Clause](../../../visual-basic/language-reference/queries/distinct-clause.md) + [Distinct Clause](distinct-clause.md) Describes the `Distinct` clause, which restricts the values of the current range variable to eliminate duplicate values in query results. - [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) + [From Clause](from-clause.md) Describes the `From` clause, which specifies a collection and a range variable for a query. - [Group By Clause](../../../visual-basic/language-reference/queries/group-by-clause.md) + [Group By Clause](group-by-clause.md) Describes the `Group By` clause, which groups the elements of a query result and can be used to apply aggregate functions to each group. - [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) + [Group Join Clause](group-join-clause.md) Describes the `Group Join` clause, which combines two collections into a single hierarchical collection. - [Join Clause](../../../visual-basic/language-reference/queries/join-clause.md) + [Join Clause](join-clause.md) Describes the `Join` clause, which combines two collections into a single collection. - [Let Clause](../../../visual-basic/language-reference/queries/let-clause.md) + [Let Clause](let-clause.md) Describes the `Let` clause, which computes a value and assigns it to a new variable in the query. - [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md) + [Order By Clause](order-by-clause.md) Describes the `Order By` clause, which specifies the sort order for columns in a query. - [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) + [Select Clause](select-clause.md) Describes the `Select` clause, which declares a set of range variables for a query. - [Skip Clause](../../../visual-basic/language-reference/queries/skip-clause.md) + [Skip Clause](skip-clause.md) Describes the `Skip` clause, which bypasses a specified number of elements in a collection and then returns the remaining elements. - [Skip While Clause](../../../visual-basic/language-reference/queries/skip-while-clause.md) + [Skip While Clause](skip-while-clause.md) Describes the `Skip While` clause, which bypasses elements in a collection as long as a specified condition is `true` and then returns the remaining elements. - [Take Clause](../../../visual-basic/language-reference/queries/take-clause.md) + [Take Clause](take-clause.md) Describes the `Take` clause, which returns a specified number of contiguous elements from the start of a collection. - [Take While Clause](../../../visual-basic/language-reference/queries/take-while-clause.md) + [Take While Clause](take-while-clause.md) Describes the `Take While` clause, which includes elements in a collection as long as a specified condition is `true` and bypasses the remaining elements. - [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) + [Where Clause](where-clause.md) Describes the `Where` clause, which specifies a filtering condition for a query. ## See also -- [LINQ](../../../visual-basic/programming-guide/language-features/linq/index.md) -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) +- [LINQ](../../programming-guide/language-features/linq/index.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) diff --git a/docs/visual-basic/language-reference/queries/join-clause.md b/docs/visual-basic/language-reference/queries/join-clause.md index 60b9f3a0046b3..bd4121bb73fc6 100644 --- a/docs/visual-basic/language-reference/queries/join-clause.md +++ b/docs/visual-basic/language-reference/queries/join-clause.md @@ -89,9 +89,9 @@ The example will produce output similar to the following: ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Group Join Clause](group-join-clause.md) +- [Where Clause](where-clause.md) diff --git a/docs/visual-basic/language-reference/queries/let-clause.md b/docs/visual-basic/language-reference/queries/let-clause.md index f0b58e42d3a22..276fa7e753ff8 100644 --- a/docs/visual-basic/language-reference/queries/let-clause.md +++ b/docs/visual-basic/language-reference/queries/let-clause.md @@ -37,8 +37,8 @@ Let variable = expression [, ...] ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Where Clause](where-clause.md) diff --git a/docs/visual-basic/language-reference/queries/order-by-clause.md b/docs/visual-basic/language-reference/queries/order-by-clause.md index d947847a5c902..7cd44ef441a23 100644 --- a/docs/visual-basic/language-reference/queries/order-by-clause.md +++ b/docs/visual-basic/language-reference/queries/order-by-clause.md @@ -46,7 +46,7 @@ Order By orderExp1 [ Ascending | Descending ] [, orderExp2 [...] ] ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) diff --git a/docs/visual-basic/language-reference/queries/select-clause.md b/docs/visual-basic/language-reference/queries/select-clause.md index be9ebe7634a20..11c5435e44837 100644 --- a/docs/visual-basic/language-reference/queries/select-clause.md +++ b/docs/visual-basic/language-reference/queries/select-clause.md @@ -26,7 +26,7 @@ Select [ var1 = ] fieldName1 [, [ var2 = ] fieldName2 [...] ] Required. The name of the field to return in the query result. ## Remarks - You can use the `Select` clause to define the results to return from a query. This enables you to either define the members of a new anonymous type that is created by a query, or to target the members of a named type that is returned by a query. The `Select` clause is not required for a query. If no `Select` clause is specified, the query will return a type based on all members of the range variables identified for the current scope. For more information, see [Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/anonymous-types.md). When a query creates a named type, it will return a result of type where `T` is the created type. + You can use the `Select` clause to define the results to return from a query. This enables you to either define the members of a new anonymous type that is created by a query, or to target the members of a named type that is returned by a query. The `Select` clause is not required for a query. If no `Select` clause is specified, the query will return a type based on all members of the range variables identified for the current scope. For more information, see [Anonymous Types](../../programming-guide/language-features/objects-and-classes/anonymous-types.md). When a query creates a named type, it will return a result of type where `T` is the created type. The `Select` clause can reference any variables in the current scope. This includes range variables identified in the `From` clause (or `From` clauses). It also includes any new variables created with an alias by the `Aggregate`, `Let`, `Group By`, or `Group Join` clauses, or variables from a previous `Select` clause in the query expression. The `Select` clause can also include static values. For example, the following code example shows a query expression in which the `Select` clause defines the query result as a new anonymous type with four members: `ProductName`, `Price`, `Discount`, and `DiscountedPrice`. The `ProductName` and `Price` member values are taken from the product range variable that is defined in the `From` clause. The `DiscountedPrice` member value is calculated in the `Let` clause. The `Discount` member is a static value. @@ -47,9 +47,9 @@ Select [ var1 = ] fieldName1 [, [ var2 = ] fieldName2 [...] ] ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) -- [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md) -- [Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/anonymous-types.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [From Clause](from-clause.md) +- [Where Clause](where-clause.md) +- [Order By Clause](order-by-clause.md) +- [Anonymous Types](../../programming-guide/language-features/objects-and-classes/anonymous-types.md) diff --git a/docs/visual-basic/language-reference/queries/skip-clause.md b/docs/visual-basic/language-reference/queries/skip-clause.md index 292d52f15a675..07b0caef9445a 100644 --- a/docs/visual-basic/language-reference/queries/skip-clause.md +++ b/docs/visual-basic/language-reference/queries/skip-clause.md @@ -27,7 +27,7 @@ Skip count You can use the `Skip` clause with the `Take` clause to return a range of data from any segment of a query. To do this, pass the index of the first element of the range to the `Skip` clause and the size of the range to the `Take` clause. - When you use the `Skip` clause in a query, you may also need to ensure that the results are returned in an order that will enable the `Skip` clause to bypass the intended results. For more information about ordering query results, see [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md). + When you use the `Skip` clause in a query, you may also need to ensure that the results are returned in an order that will enable the `Skip` clause to bypass the intended results. For more information about ordering query results, see [Order By Clause](order-by-clause.md). You can use the `SkipWhile` clause to specify that only certain elements are ignored, depending on a supplied condition. @@ -38,10 +38,10 @@ Skip count ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md) -- [Skip While Clause](../../../visual-basic/language-reference/queries/skip-while-clause.md) -- [Take Clause](../../../visual-basic/language-reference/queries/take-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Order By Clause](order-by-clause.md) +- [Skip While Clause](skip-while-clause.md) +- [Take Clause](take-clause.md) diff --git a/docs/visual-basic/language-reference/queries/skip-while-clause.md b/docs/visual-basic/language-reference/queries/skip-while-clause.md index 1d1646d1d5aba..1ef5a82b668a7 100644 --- a/docs/visual-basic/language-reference/queries/skip-while-clause.md +++ b/docs/visual-basic/language-reference/queries/skip-while-clause.md @@ -38,10 +38,10 @@ Skip While expression ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Skip Clause](../../../visual-basic/language-reference/queries/skip-clause.md) -- [Take While Clause](../../../visual-basic/language-reference/queries/take-while-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Skip Clause](skip-clause.md) +- [Take While Clause](take-while-clause.md) +- [Where Clause](where-clause.md) diff --git a/docs/visual-basic/language-reference/queries/take-clause.md b/docs/visual-basic/language-reference/queries/take-clause.md index d12d37620ba25..4890305752ecf 100644 --- a/docs/visual-basic/language-reference/queries/take-clause.md +++ b/docs/visual-basic/language-reference/queries/take-clause.md @@ -27,7 +27,7 @@ Take count You can use the `Take` clause with the `Skip` clause to return a range of data from any segment of a query. To do this, pass the index of the first element of the range to the `Skip` clause and the size of the range to the `Take` clause. In this case, the `Take` clause must be specified after the `Skip` clause. - When you use the `Take` clause in a query, you may also need to ensure that the results are returned in an order that will enable the `Take` clause to include the intended results. For more information about ordering query results, see [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md). + When you use the `Take` clause in a query, you may also need to ensure that the results are returned in an order that will enable the `Take` clause to include the intended results. For more information about ordering query results, see [Order By Clause](order-by-clause.md). You can use the `TakeWhile` clause to specify that only certain elements be returned, depending on a supplied condition. @@ -38,10 +38,10 @@ Take count ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Order By Clause](../../../visual-basic/language-reference/queries/order-by-clause.md) -- [Take While Clause](../../../visual-basic/language-reference/queries/take-while-clause.md) -- [Skip Clause](../../../visual-basic/language-reference/queries/skip-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Order By Clause](order-by-clause.md) +- [Take While Clause](take-while-clause.md) +- [Skip Clause](skip-clause.md) diff --git a/docs/visual-basic/language-reference/queries/take-while-clause.md b/docs/visual-basic/language-reference/queries/take-while-clause.md index f53964a15f497..e94bfed173359 100644 --- a/docs/visual-basic/language-reference/queries/take-while-clause.md +++ b/docs/visual-basic/language-reference/queries/take-while-clause.md @@ -36,10 +36,10 @@ Take While expression ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Take Clause](../../../visual-basic/language-reference/queries/take-clause.md) -- [Skip While Clause](../../../visual-basic/language-reference/queries/skip-while-clause.md) -- [Where Clause](../../../visual-basic/language-reference/queries/where-clause.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [Select Clause](select-clause.md) +- [From Clause](from-clause.md) +- [Take Clause](take-clause.md) +- [Skip While Clause](skip-while-clause.md) +- [Where Clause](where-clause.md) diff --git a/docs/visual-basic/language-reference/queries/where-clause.md b/docs/visual-basic/language-reference/queries/where-clause.md index c323ebcec786b..4dcc55b04532d 100644 --- a/docs/visual-basic/language-reference/queries/where-clause.md +++ b/docs/visual-basic/language-reference/queries/where-clause.md @@ -25,9 +25,9 @@ Where condition ## Remarks The `Where` clause enables you to filter query data by selecting only elements that meet certain criteria. Elements whose values cause the `Where` clause to evaluate to `True` are included in the query result; other elements are excluded. The expression that is used in a `Where` clause must evaluate to a `Boolean` or the equivalent of a `Boolean`, such as an Integer that evaluates to `False` when its value is zero. You can combine multiple expressions in a `Where` clause by using logical operators such as `And`, `Or`, `AndAlso`, `OrElse`, `Is`, and `IsNot`. - By default, query expressions are not evaluated until they are accessed—for example, when they are data-bound or iterated through in a `For` loop. As a result, the `Where` clause is not evaluated until the query is accessed. If you have values external to the query that are used in the `Where` clause, ensure that the appropriate value is used in the `Where` clause at the time the query is executed. For more information about query execution, see [Writing Your First LINQ Query](../../../visual-basic/programming-guide/concepts/linq/writing-your-first-linq-query.md). + By default, query expressions are not evaluated until they are accessed—for example, when they are data-bound or iterated through in a `For` loop. As a result, the `Where` clause is not evaluated until the query is accessed. If you have values external to the query that are used in the `Where` clause, ensure that the appropriate value is used in the `Where` clause at the time the query is executed. For more information about query execution, see [Writing Your First LINQ Query](../../programming-guide/concepts/linq/writing-your-first-linq-query.md). - You can call functions within a `Where` clause to perform a calculation or operation on a value from the current element in the collection. Calling a function in a `Where` clause can cause the query to be executed immediately when it is defined instead of when it is accessed. For more information about query execution, see [Writing Your First LINQ Query](../../../visual-basic/programming-guide/concepts/linq/writing-your-first-linq-query.md). + You can call functions within a `Where` clause to perform a calculation or operation on a value from the current element in the collection. Calling a function in a `Where` clause can cause the query to be executed immediately when it is defined instead of when it is accessed. For more information about query execution, see [Writing Your First LINQ Query](../../programming-guide/concepts/linq/writing-your-first-linq-query.md). ## Example The following query expression uses a `From` clause to declare a range variable `cust` for each `Customer` object in the `customers` collection. The `Where` clause uses the range variable to restrict the output to customers from the specified region. The `For Each` loop displays the company name for each customer in the query result. @@ -41,8 +41,8 @@ Where condition ## See also -- [Introduction to LINQ in Visual Basic](../../../visual-basic/programming-guide/language-features/linq/introduction-to-linq.md) -- [Queries](../../../visual-basic/language-reference/queries/index.md) -- [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) -- [Select Clause](../../../visual-basic/language-reference/queries/select-clause.md) -- [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md) +- [Introduction to LINQ in Visual Basic](../../programming-guide/language-features/linq/introduction-to-linq.md) +- [Queries](index.md) +- [From Clause](from-clause.md) +- [Select Clause](select-clause.md) +- [For Each...Next Statement](../statements/for-each-next-statement.md) diff --git a/docs/visual-basic/language-reference/runtime-library-members.md b/docs/visual-basic/language-reference/runtime-library-members.md index 0629e11de5f55..bad181bf52d03 100644 --- a/docs/visual-basic/language-reference/runtime-library-members.md +++ b/docs/visual-basic/language-reference/runtime-library-members.md @@ -187,9 +187,9 @@ The `Microsoft.VisualBasic` namespace contains the classes, modules, constants, ## Microsoft.VisualBasic Constants and Enumerations - The `Microsoft.VisualBasic` namespace provides constants and enumerations as part of the Visual Basic run-time library. You can use these constant values in your code. Each enumeration represents a particular category of functionality. For more information, see [Constants and Enumerations](../../visual-basic/language-reference/constants-and-enumerations.md). + The `Microsoft.VisualBasic` namespace provides constants and enumerations as part of the Visual Basic run-time library. You can use these constant values in your code. Each enumeration represents a particular category of functionality. For more information, see [Constants and Enumerations](constants-and-enumerations.md). ## See also -- [Constants and Enumerations](../../visual-basic/language-reference/constants-and-enumerations.md) -- [Keywords](../../visual-basic/language-reference/keywords/index.md) +- [Constants and Enumerations](constants-and-enumerations.md) +- [Keywords](keywords/index.md) diff --git a/docs/visual-basic/language-reference/special-characters/index.md b/docs/visual-basic/language-reference/special-characters/index.md index 81abff59662c6..f2d40164b9f09 100644 --- a/docs/visual-basic/language-reference/special-characters/index.md +++ b/docs/visual-basic/language-reference/special-characters/index.md @@ -11,4 +11,4 @@ Special characters are predefined, contextual characters that modifies the progr ## See also -- [Visual Basic Reference](../../../visual-basic/language-reference/index.md) +- [Visual Basic Reference](../index.md) diff --git a/docs/visual-basic/language-reference/statements/addhandler-statement.md b/docs/visual-basic/language-reference/statements/addhandler-statement.md index 127a1f6b13c9f..f30314b5e93ff 100644 --- a/docs/visual-basic/language-reference/statements/addhandler-statement.md +++ b/docs/visual-basic/language-reference/statements/addhandler-statement.md @@ -30,17 +30,17 @@ AddHandler event, AddressOf eventhandler The signature of the `eventhandler` procedure must match the signature of the event `event`. - The `Handles` keyword and the `AddHandler` statement both allow you to specify that particular procedures handle particular events, but there are differences. The `AddHandler` statement connects procedures to events at run time. Use the `Handles` keyword when defining a procedure to specify that it handles a particular event. For more information, see [Handles](../../../visual-basic/language-reference/statements/handles-clause.md). + The `Handles` keyword and the `AddHandler` statement both allow you to specify that particular procedures handle particular events, but there are differences. The `AddHandler` statement connects procedures to events at run time. Use the `Handles` keyword when defining a procedure to specify that it handles a particular event. For more information, see [Handles](handles-clause.md). > [!NOTE] -> For custom events, the `AddHandler` statement invokes the event's `AddHandler` accessor. For more information on custom events, see [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md). +> For custom events, the `AddHandler` statement invokes the event's `AddHandler` accessor. For more information on custom events, see [Event Statement](event-statement.md). ## Example [!code-vb[VbVbalrEvents#17](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb#17)] ## See also -- [RemoveHandler Statement](../../../visual-basic/language-reference/statements/removehandler-statement.md) -- [Handles](../../../visual-basic/language-reference/statements/handles-clause.md) -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [RemoveHandler Statement](removehandler-statement.md) +- [Handles](handles-clause.md) +- [Event Statement](event-statement.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/statements/alias-clause.md b/docs/visual-basic/language-reference/statements/alias-clause.md index 25e126a1243f3..ff4392cce44e8 100644 --- a/docs/visual-basic/language-reference/statements/alias-clause.md +++ b/docs/visual-basic/language-reference/statements/alias-clause.md @@ -13,7 +13,7 @@ Indicates that an external procedure has another name in its DLL. ## Remarks The `Alias` keyword can be used in this context: - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](declare-statement.md) In the following example, the `Alias` keyword is used to provide the name of the function in advapi32.dll, `GetUserNameA`, that `getUserName` is used in place of in this example. Function `getUserName` is called in sub `getUser`, which displays the name of the current user. @@ -21,4 +21,4 @@ Indicates that an external procedure has another name in its DLL. ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/statements/as-clause.md b/docs/visual-basic/language-reference/statements/as-clause.md index d0ef0a572bb19..93fa14bca3ccb 100644 --- a/docs/visual-basic/language-reference/statements/as-clause.md +++ b/docs/visual-basic/language-reference/statements/as-clause.md @@ -15,49 +15,49 @@ Introduces an `As` clause, which identifies a data type in a declaration stateme ## Remarks The `As` keyword can be used in these contexts: - [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md) + [Aggregate Clause](../queries/aggregate-clause.md) - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](class-statement.md) - [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) + [Const Statement](const-statement.md) - [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) + [Declare Statement](declare-statement.md) - [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) + [Delegate Statement](delegate-statement.md) - [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) + [Dim Statement](dim-statement.md) - [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) + [Enum Statement](enum-statement.md) - [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) + [Event Statement](event-statement.md) - [For...Next Statements](../../../visual-basic/language-reference/statements/for-next-statement.md) + [For...Next Statements](for-next-statement.md) - [For Each...Next Statements](../../../visual-basic/language-reference/statements/for-each-next-statement.md) + [For Each...Next Statements](for-each-next-statement.md) - [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) + [From Clause](../queries/from-clause.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](function-statement.md) - [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) + [Group Join Clause](../queries/group-join-clause.md) - [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) + [Interface Statement](interface-statement.md) - [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) + [Operator Statement](operator-statement.md) - [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) + [Property Statement](property-statement.md) - [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) + [Structure Statement](structure-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](sub-statement.md) - [Try...Catch...Finally Statements](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) + [Try...Catch...Finally Statements](try-catch-finally-statement.md) ## See also -- [How to: Create a New Variable](../../../visual-basic/programming-guide/language-features/variables/how-to-create-a-new-variable.md) -- [Data Types](../../../visual-basic/programming-guide/language-features/data-types/index.md) -- [Variable Declaration](../../../visual-basic/programming-guide/language-features/variables/variable-declaration.md) -- [Type List](../../../visual-basic/language-reference/statements/type-list.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [How to: Create a New Variable](../../programming-guide/language-features/variables/how-to-create-a-new-variable.md) +- [Data Types](../../programming-guide/language-features/data-types/index.md) +- [Variable Declaration](../../programming-guide/language-features/variables/variable-declaration.md) +- [Type List](type-list.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/statements/attribute-list.md b/docs/visual-basic/language-reference/statements/attribute-list.md index 4b5bcd30fc47e..8b5a34d9352ba 100644 --- a/docs/visual-basic/language-reference/statements/attribute-list.md +++ b/docs/visual-basic/language-reference/statements/attribute-list.md @@ -18,7 +18,7 @@ Specifies the attributes to be applied to a declared programming element. Multip ## Parts ||| |---|---| -|`attributemodifier`|Required for attributes applied at the beginning of a source file. Can be [Assembly](../../../visual-basic/language-reference/modifiers/assembly.md) or [Module](../../../visual-basic/language-reference/modifiers/module-keyword.md).| +|`attributemodifier`|Required for attributes applied at the beginning of a source file. Can be [Assembly](../modifiers/assembly.md) or [Module](../modifiers/module-keyword.md).| |`attributename`| Required. Name of the attribute.| |`attributearguments`|Optional. List of positional arguments for this attribute. Multiple arguments are separated by commas.| |`attributeinitializer`|Optional. List of variable or property initializers for this attribute. Multiple initializers are separated by commas.| @@ -26,7 +26,7 @@ Specifies the attributes to be applied to a declared programming element. Multip ## Remarks You can apply one or more attributes to nearly any programming element (types, procedures, properties, and so forth). Attributes appear in your assembly's metadata, and they can help you annotate your code or specify how to use a particular programming element. You can apply attributes defined by Visual Basic and the .NET Framework, and you can define your own attributes. - For more information on when to use attributes, see [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md). For information on attribute names, see [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). + For more information on when to use attributes, see [Attributes overview](../../programming-guide/concepts/attributes/index.md). For information on attribute names, see [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). ## Rules @@ -49,7 +49,7 @@ Specifies the attributes to be applied to a declared programming element. Multip ## See also -- [Assembly](../../../visual-basic/language-reference/modifiers/assembly.md) -- [Module \](../../../visual-basic/language-reference/modifiers/module-keyword.md) -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) -- [How to: Break and Combine Statements in Code](../../../visual-basic/programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) +- [Assembly](../modifiers/assembly.md) +- [Module \](../modifiers/module-keyword.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) +- [How to: Break and Combine Statements in Code](../../programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) diff --git a/docs/visual-basic/language-reference/statements/class-statement.md b/docs/visual-basic/language-reference/statements/class-statement.md index dcae35ee5fc59..ac4ef31624220 100644 --- a/docs/visual-basic/language-reference/statements/class-statement.md +++ b/docs/visual-basic/language-reference/statements/class-statement.md @@ -32,56 +32,56 @@ End Class |Term|Definition| |---|---| -|`attributelist`|Optional. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md).| -|`accessmodifier`|Optional. Can be one of the following:

- [Public](../../../visual-basic/language-reference/modifiers/public.md)
- [Protected](../../../visual-basic/language-reference/modifiers/protected.md)
- [Friend](../../../visual-basic/language-reference/modifiers/friend.md)
- [Private](../../../visual-basic/language-reference/modifiers/private.md)
- [Protected Friend](../../language-reference/modifiers/protected-friend.md)
- [Private Protected](../../language-reference/modifiers/private-protected.md)

See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md).| -|`Shadows`|Optional. See [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md).| -|`MustInherit`|Optional. See [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md).| -|`NotInheritable`|Optional. See [NotInheritable](../../../visual-basic/language-reference/modifiers/notinheritable.md).| -|`Partial`|Optional. Indicates a partial definition of the class. See [Partial](../../../visual-basic/language-reference/modifiers/partial.md).| -|`name`|Required. Name of this class. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md).| +|`attributelist`|Optional. See [Attribute List](attribute-list.md).| +|`accessmodifier`|Optional. Can be one of the following:

- [Public](../modifiers/public.md)
- [Protected](../modifiers/protected.md)
- [Friend](../modifiers/friend.md)
- [Private](../modifiers/private.md)
- [Protected Friend](../modifiers/protected-friend.md)
- [Private Protected](../modifiers/private-protected.md)

See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md).| +|`Shadows`|Optional. See [Shadows](../modifiers/shadows.md).| +|`MustInherit`|Optional. See [MustInherit](../modifiers/mustinherit.md).| +|`NotInheritable`|Optional. See [NotInheritable](../modifiers/notinheritable.md).| +|`Partial`|Optional. Indicates a partial definition of the class. See [Partial](../modifiers/partial.md).| +|`name`|Required. Name of this class. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md).| |`Of`|Optional. Specifies that this is a generic class.| -|`typelist`|Required if you use the [Of](../../../visual-basic/language-reference/statements/of-clause.md) keyword. List of type parameters for this class. See [Type List](../../../visual-basic/language-reference/statements/type-list.md).| -|`Inherits`|Optional. Indicates that this class inherits the members of another class. See [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md).| +|`typelist`|Required if you use the [Of](of-clause.md) keyword. List of type parameters for this class. See [Type List](type-list.md).| +|`Inherits`|Optional. Indicates that this class inherits the members of another class. See [Inherits Statement](inherits-statement.md).| |`classname`|Required if you use the `Inherits` statement. The name of the class from which this class derives.| -|`Implements`|Optional. Indicates that this class implements the members of one or more interfaces. See [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md).| +|`Implements`|Optional. Indicates that this class implements the members of one or more interfaces. See [Implements Statement](implements-statement.md).| |`interfacenames`|Required if you use the `Implements` statement. The names of the interfaces this class implements.| |`statements`|Optional. Statements which define the members of this class.| |`End Class`|Required. Terminates the `Class` definition.| ## Remarks - A `Class` statement defines a new data type. A *class* is a fundamental building block of object-oriented programming (OOP). For more information, see [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md). + A `Class` statement defines a new data type. A *class* is a fundamental building block of object-oriented programming (OOP). For more information, see [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md). - You can use `Class` only at namespace or module level. This means the *declaration context* for a class must be a source file, namespace, class, structure, module, or interface, and cannot be a procedure or block. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). + You can use `Class` only at namespace or module level. This means the *declaration context* for a class must be a source file, namespace, class, structure, module, or interface, and cannot be a procedure or block. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). - Each instance of a class has a lifetime independent of all other instances. This lifetime begins when it is created by a [New Operator](../../../visual-basic/language-reference/operators/new-operator.md) clause or by a function such as . It ends when all variables pointing to the instance have been set to [Nothing](../../../visual-basic/language-reference/nothing.md) or to instances of other classes. + Each instance of a class has a lifetime independent of all other instances. This lifetime begins when it is created by a [New Operator](../operators/new-operator.md) clause or by a function such as . It ends when all variables pointing to the instance have been set to [Nothing](../nothing.md) or to instances of other classes. - Classes default to [Friend](../../../visual-basic/language-reference/modifiers/friend.md) access. You can adjust their access levels with the access modifiers. For more information, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). + Classes default to [Friend](../modifiers/friend.md) access. You can adjust their access levels with the access modifiers. For more information, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). ## Rules - **Nesting.** You can define one class within another. The outer class is called the *containing class*, and the inner class is called a *nested class*. -- **Inheritance.** If the class uses the [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md), you can specify only one base class or interface. A class cannot inherit from more than one element. +- **Inheritance.** If the class uses the [Inherits Statement](inherits-statement.md), you can specify only one base class or interface. A class cannot inherit from more than one element. A class cannot inherit from another class with a more restrictive access level. For example, a `Public` class cannot inherit from a `Friend` class. A class cannot inherit from a class nested within it. -- **Implementation.** If the class uses the [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md), you must implement every member defined by every interface you specify in `interfacenames`. An exception to this is reimplementation of a base class member. For more information, see "Reimplementation" in [Implements](../../../visual-basic/language-reference/statements/implements-clause.md). +- **Implementation.** If the class uses the [Implements Statement](implements-statement.md), you must implement every member defined by every interface you specify in `interfacenames`. An exception to this is reimplementation of a base class member. For more information, see "Reimplementation" in [Implements](implements-clause.md). -- **Default Property.** A class can specify at most one property as its *default property*. For more information, see [Default](../../../visual-basic/language-reference/modifiers/default.md). +- **Default Property.** A class can specify at most one property as its *default property*. For more information, see [Default](../modifiers/default.md). ## Behavior -- **Access Level.** Within a class, you can declare each member with its own access level. Class members default to [Public](../../../visual-basic/language-reference/modifiers/public.md) access, except variables and constants, which default to [Private](../../../visual-basic/language-reference/modifiers/private.md) access. When a class has more restricted access than one of its members, the class access level takes precedence. +- **Access Level.** Within a class, you can declare each member with its own access level. Class members default to [Public](../modifiers/public.md) access, except variables and constants, which default to [Private](../modifiers/private.md) access. When a class has more restricted access than one of its members, the class access level takes precedence. - **Scope.** A class is in scope throughout its containing namespace, class, structure, or module. The scope of every class member is the entire class. - **Lifetime.** Visual Basic does not support static classes. The functional equivalent of a static class is provided by a module. For more information, see [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md). + **Lifetime.** Visual Basic does not support static classes. The functional equivalent of a static class is provided by a module. For more information, see [Module Statement](module-statement.md). - Class members have lifetimes depending on how and where they are declared. For more information, see [Lifetime in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/lifetime.md). + Class members have lifetimes depending on how and where they are declared. For more information, see [Lifetime in Visual Basic](../../programming-guide/language-features/declared-elements/lifetime.md). - **Qualification.** Code outside a class must qualify a member's name with the name of that class. @@ -94,7 +94,7 @@ End Class - **Shared Members.** You can control whether a member of a class is a shared or instance member. -- **Object Orientation.** Classes are object-oriented, but modules are not. You can create one or more instances of a class. For more information, see [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md). +- **Object Orientation.** Classes are object-oriented, but modules are not. You can create one or more instances of a class. For more information, see [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md). ## Example The following example uses a `Class` statement to define a class and several members. @@ -103,11 +103,11 @@ End Class ## See also -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) -- [Structures and Classes](../../../visual-basic/programming-guide/language-features/data-types/structures-and-classes.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) -- [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Object Lifetime: How Objects Are Created and Destroyed](../../../visual-basic/programming-guide/language-features/objects-and-classes/object-lifetime-how-objects-are-created-and-destroyed.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [How to: Use a Generic Class](../../../visual-basic/programming-guide/language-features/data-types/how-to-use-a-generic-class.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) +- [Structures and Classes](../../programming-guide/language-features/data-types/structures-and-classes.md) +- [Interface Statement](interface-statement.md) +- [Module Statement](module-statement.md) +- [Property Statement](property-statement.md) +- [Object Lifetime: How Objects Are Created and Destroyed](../../programming-guide/language-features/objects-and-classes/object-lifetime-how-objects-are-created-and-destroyed.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [How to: Use a Generic Class](../../programming-guide/language-features/data-types/how-to-use-a-generic-class.md) diff --git a/docs/visual-basic/language-reference/statements/clauses.md b/docs/visual-basic/language-reference/statements/clauses.md index 11517419e1d91..a4e46251a2288 100644 --- a/docs/visual-basic/language-reference/statements/clauses.md +++ b/docs/visual-basic/language-reference/statements/clauses.md @@ -9,19 +9,19 @@ ms.assetid: 5e89f5f3-d129-4ed1-8857-30cd71cff95e The topics in this section document Visual Basic run-time clauses. ## In This Section - [Alias](../../../visual-basic/language-reference/statements/alias-clause.md) + [Alias](alias-clause.md) - [As](../../../visual-basic/language-reference/statements/as-clause.md) + [As](as-clause.md) - [Handles](../../../visual-basic/language-reference/statements/handles-clause.md) + [Handles](handles-clause.md) - [Implements](../../../visual-basic/language-reference/statements/implements-clause.md) + [Implements](implements-clause.md) - [In](../../../visual-basic/language-reference/statements/in-clause.md) + [In](in-clause.md) - [Into](../../../visual-basic/language-reference/statements/into-clause.md) + [Into](into-clause.md) - [Of](../../../visual-basic/language-reference/statements/of-clause.md) + [Of](of-clause.md) ## Related Sections - [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) + [Visual Basic Language Reference](../index.md) diff --git a/docs/visual-basic/language-reference/statements/const-statement.md b/docs/visual-basic/language-reference/statements/const-statement.md index 8213362c2a764..29da9623f17a6 100644 --- a/docs/visual-basic/language-reference/statements/const-statement.md +++ b/docs/visual-basic/language-reference/statements/const-statement.md @@ -21,13 +21,13 @@ Const constantlist ## Parts `attributelist` -Optional. List of attributes that apply to all the constants declared in this statement. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md) in angle brackets ("`<`" and "`>`"). +Optional. List of attributes that apply to all the constants declared in this statement. See [Attribute List](attribute-list.md) in angle brackets ("`<`" and "`>`"). `accessmodifier` -Optional. Use this to specify what code can access these constants. Can be [Public](../../../visual-basic/language-reference/modifiers/public.md), [Protected](../../../visual-basic/language-reference/modifiers/protected.md), [Friend](../../../visual-basic/language-reference/modifiers/friend.md), [Protected Friend](../modifiers/protected-friend.md), [Private](../../../visual-basic/language-reference/modifiers/private.md), or [Private Protected](../../language-reference/modifiers/private-protected.md). +Optional. Use this to specify what code can access these constants. Can be [Public](../modifiers/public.md), [Protected](../modifiers/protected.md), [Friend](../modifiers/friend.md), [Protected Friend](../modifiers/protected-friend.md), [Private](../modifiers/private.md), or [Private Protected](../modifiers/private-protected.md). `Shadows` -Optional. Use this to redeclare and hide a programming element in a base class. See [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md). +Optional. Use this to redeclare and hide a programming element in a base class. See [Shadows](../modifiers/shadows.md). `constantlist` Required. List of constants being declared in this statement. @@ -40,7 +40,7 @@ Each `constant` has the following syntax and parts: |Part|Description| |----------|-----------------| -|`constantname`|Required. Name of the constant. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md).| +|`constantname`|Required. Name of the constant. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md).| |`datatype`|Required if `Option Strict` is `On`. Data type of the constant.| |`initializer`|Required. Expression that is evaluated at compile time and assigned to the constant.| @@ -48,7 +48,7 @@ Each `constant` has the following syntax and parts: If you have a value that never changes in your application, you can define a named constant and use it in place of a literal value. A name is easier to remember than a value. You can define the constant just once and use it in many places in your code. If in a later version you need to redefine the value, the `Const` statement is the only place you need to make a change. -You can use `Const` only at module or procedure level. This means the *declaration context* for a variable must be a class, structure, module, procedure, or block, and cannot be a source file, namespace, or interface. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). +You can use `Const` only at module or procedure level. This means the *declaration context* for a variable must be a class, structure, module, procedure, or block, and cannot be a source file, namespace, or interface. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). Local constants (inside a procedure) default to public access, and you cannot use any access modifiers on them. Class and module member constants (outside any procedure) default to private access, and structure member constants default to public access. You can adjust their access levels with the access modifiers. @@ -96,17 +96,17 @@ If you define a constant with data type `Object`, the Visual Basic compiler give [!code-vb[VbVbalrStatements#87](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/Class1.vb#87)] -The preceding example uses the method on the object returned by the [GetType Operator](../../../visual-basic/language-reference/operators/gettype-operator.md), because cannot be converted to `String` using `CStr`. +The preceding example uses the method on the object returned by the [GetType Operator](../operators/gettype-operator.md), because cannot be converted to `String` using `CStr`. ## See also - - -- [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md) -- [#Const Directive](../../../visual-basic/language-reference/directives/const-directive.md) -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) -- [ReDim Statement](../../../visual-basic/language-reference/statements/redim-statement.md) -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) -- [Constants and Enumerations](../../../visual-basic/programming-guide/language-features/constants-enums/index.md) -- [Constants and Enumerations](../../../visual-basic/language-reference/constants-and-enumerations.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) +- [Enum Statement](enum-statement.md) +- [#Const Directive](../directives/const-directive.md) +- [Dim Statement](dim-statement.md) +- [ReDim Statement](redim-statement.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Constants and Enumerations](../../programming-guide/language-features/constants-enums/index.md) +- [Constants and Enumerations](../constants-and-enumerations.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) diff --git a/docs/visual-basic/language-reference/statements/continue-statement.md b/docs/visual-basic/language-reference/statements/continue-statement.md index 18bd25e503636..880d84c34dc48 100644 --- a/docs/visual-basic/language-reference/statements/continue-statement.md +++ b/docs/visual-basic/language-reference/statements/continue-statement.md @@ -20,7 +20,7 @@ Continue { Do | For | While } ## Remarks You can transfer from inside a `Do`, `For`, or `While` loop to the next iteration of that loop. Control passes immediately to the loop condition test, which is equivalent to transferring to the `For` or `While` statement, or to the `Do` or `Loop` statement that contains the `Until` or `While` clause. - You can use `Continue` at any location in the loop that allows transfers. The rules allowing transfer of control are the same as with the [GoTo Statement](../../../visual-basic/language-reference/statements/goto-statement.md). + You can use `Continue` at any location in the loop that allows transfers. The rules allowing transfer of control are the same as with the [GoTo Statement](goto-statement.md). For example, if a loop is totally contained within a `Try` block, a `Catch` block, or a `Finally` block, you can use `Continue` to transfer out of the loop. If, on the other hand, the `Try`...`End Try` structure is contained within the loop, you cannot use `Continue` to transfer control out of the `Finally` block, and you can use it to transfer out of a `Try` or `Catch` block only if you transfer completely out of the `Try`...`End Try` structure. @@ -35,7 +35,7 @@ Continue { Do | For | While } ## See also -- [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md) -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [While...End While Statement](../../../visual-basic/language-reference/statements/while-end-while-statement.md) -- [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) +- [Do...Loop Statement](do-loop-statement.md) +- [For...Next Statement](for-next-statement.md) +- [While...End While Statement](while-end-while-statement.md) +- [Try...Catch...Finally Statement](try-catch-finally-statement.md) diff --git a/docs/visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md b/docs/visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md index 9e2b0ee22b6f3..fe1c018b1298a 100644 --- a/docs/visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md +++ b/docs/visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md @@ -28,25 +28,25 @@ This topic describes which Visual Basic types can be declared within which other |Declared element|Namespace level|Module level|Procedure level| |----------------------|---------------------|------------------|---------------------| -|Variable ([Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md))|Not allowed|`Private` (`Public` in `Structure`, not allowed in `Interface`)|`Public`| -|Constant ([Const Statement](../../../visual-basic/language-reference/statements/const-statement.md))|Not allowed|`Private` (`Public` in `Structure`, not allowed in `Interface`)|`Public`| -|Enumeration ([Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md))|`Friend`|`Public`|Not allowed| -|Class ([Class Statement](../../../visual-basic/language-reference/statements/class-statement.md))|`Friend`|`Public`|Not allowed| -|Structure ([Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md))|`Friend`|`Public`|Not allowed| -|Module ([Module Statement](../../../visual-basic/language-reference/statements/module-statement.md))|`Friend`|Not allowed|Not allowed| -|Interface ([Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md))|`Friend`|`Public`|Not allowed| -|Procedure ([Function Statement](../../../visual-basic/language-reference/statements/function-statement.md), [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md))|Not allowed|`Public`|Not allowed| -|External reference ([Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md))|Not allowed|`Public` (not allowed in `Interface`)|Not allowed| -|Operator ([Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md))|Not allowed|`Public` (not allowed in `Interface` or `Module`)|Not allowed| -|Property ([Property Statement](../../../visual-basic/language-reference/statements/property-statement.md))|Not allowed|`Public`|Not allowed| -|Default property ([Default](../../../visual-basic/language-reference/modifiers/default.md))|Not allowed|`Public` (not allowed in `Module`)|Not allowed| -|Event ([Event Statement](../../../visual-basic/language-reference/statements/event-statement.md))|Not allowed|`Public`|Not allowed| -|Delegate ([Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md))|`Friend`|`Public`|Not allowed| - - For more information, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +|Variable ([Dim Statement](dim-statement.md))|Not allowed|`Private` (`Public` in `Structure`, not allowed in `Interface`)|`Public`| +|Constant ([Const Statement](const-statement.md))|Not allowed|`Private` (`Public` in `Structure`, not allowed in `Interface`)|`Public`| +|Enumeration ([Enum Statement](enum-statement.md))|`Friend`|`Public`|Not allowed| +|Class ([Class Statement](class-statement.md))|`Friend`|`Public`|Not allowed| +|Structure ([Structure Statement](structure-statement.md))|`Friend`|`Public`|Not allowed| +|Module ([Module Statement](module-statement.md))|`Friend`|Not allowed|Not allowed| +|Interface ([Interface Statement](interface-statement.md))|`Friend`|`Public`|Not allowed| +|Procedure ([Function Statement](function-statement.md), [Sub Statement](sub-statement.md))|Not allowed|`Public`|Not allowed| +|External reference ([Declare Statement](declare-statement.md))|Not allowed|`Public` (not allowed in `Interface`)|Not allowed| +|Operator ([Operator Statement](operator-statement.md))|Not allowed|`Public` (not allowed in `Interface` or `Module`)|Not allowed| +|Property ([Property Statement](property-statement.md))|Not allowed|`Public`|Not allowed| +|Default property ([Default](../modifiers/default.md))|Not allowed|`Public` (not allowed in `Module`)|Not allowed| +|Event ([Event Statement](event-statement.md))|Not allowed|`Public`|Not allowed| +|Delegate ([Delegate Statement](delegate-statement.md))|`Friend`|`Public`|Not allowed| + + For more information, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). ## See also -- [Friend](../../../visual-basic/language-reference/modifiers/friend.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) -- [Public](../../../visual-basic/language-reference/modifiers/public.md) +- [Friend](../modifiers/friend.md) +- [Private](../modifiers/private.md) +- [Public](../modifiers/public.md) diff --git a/docs/visual-basic/language-reference/statements/declare-statement.md b/docs/visual-basic/language-reference/statements/declare-statement.md index 83ae76a33da1e..fe1c2cf3a40d9 100644 --- a/docs/visual-basic/language-reference/statements/declare-statement.md +++ b/docs/visual-basic/language-reference/statements/declare-statement.md @@ -48,33 +48,33 @@ Declare [ charsetmodifier ] [ Function ] name Lib "libname" _ |Term|Definition| |---|---| -|`attributelist`|Optional. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md).| -|`accessmodifier`|Optional. Can be one of the following:

- [Public](../../../visual-basic/language-reference/modifiers/public.md)
- [Protected](../../../visual-basic/language-reference/modifiers/protected.md)
- [Friend](../../../visual-basic/language-reference/modifiers/friend.md)
- [Private](../../../visual-basic/language-reference/modifiers/private.md)
- [Protected Friend](../../language-reference/modifiers/protected-friend.md)
- [Private Protected](../../language-reference/modifiers/private-protected.md)

See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md).| -|`Shadows`|Optional. See [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md).| -|`charsetmodifier`|Optional. Specifies character set and file search information. Can be one of the following:

- [Ansi](../../../visual-basic/language-reference/modifiers/ansi.md) (default)
- [Unicode](../../../visual-basic/language-reference/modifiers/unicode.md)
- [Auto](../../../visual-basic/language-reference/modifiers/auto.md)| +|`attributelist`|Optional. See [Attribute List](attribute-list.md).| +|`accessmodifier`|Optional. Can be one of the following:

- [Public](../modifiers/public.md)
- [Protected](../modifiers/protected.md)
- [Friend](../modifiers/friend.md)
- [Private](../modifiers/private.md)
- [Protected Friend](../modifiers/protected-friend.md)
- [Private Protected](../modifiers/private-protected.md)

See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md).| +|`Shadows`|Optional. See [Shadows](../modifiers/shadows.md).| +|`charsetmodifier`|Optional. Specifies character set and file search information. Can be one of the following:

- [Ansi](../modifiers/ansi.md) (default)
- [Unicode](../modifiers/unicode.md)
- [Auto](../modifiers/auto.md)| |`Sub`|Optional, but either `Sub` or `Function` must appear. Indicates that the external procedure does not return a value.| |`Function`|Optional, but either `Sub` or `Function` must appear. Indicates that the external procedure returns a value.| -|`name`|Required. Name of this external reference. For more information, see [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md).| +|`name`|Required. Name of this external reference. For more information, see [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md).| |`Lib`|Required. Introduces a `Lib` clause, which identifies the external file (DLL or code resource) that contains an external procedure.| |`libname`|Required. Name of the file that contains the declared procedure.| |`Alias`|Optional. Indicates that the procedure being declared cannot be identified within its file by the name specified in `name`. You specify its identification in `aliasname`.| |`aliasname`|Required if you use the `Alias` keyword. String that identifies the procedure in one of two ways:

The entry point name of the procedure within its file, within quotes (`""`)

-or-

A number sign (`#`) followed by an integer specifying the ordinal number of the procedure's entry point within its file| -|`parameterlist`|Required if the procedure takes parameters. See [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md).| +|`parameterlist`|Required if the procedure takes parameters. See [Parameter List](parameter-list.md).| |`returntype`|Required if `Function` is specified and `Option Strict` is `On`. Data type of the value returned by the procedure.| ## Remarks Sometimes you need to call a procedure defined in a file (such as a DLL or code resource) outside your project. When you do this, the Visual Basic compiler does not have access to the information it needs to call the procedure correctly, such as where the procedure is located, how it is identified, its calling sequence and return type, and the string character set it uses. The `Declare` statement creates a reference to an external procedure and supplies this necessary information. -You can use `Declare` only at module level. This means the *declaration context* for an external reference must be a class, structure, or module, and cannot be a source file, namespace, interface, procedure, or block. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). +You can use `Declare` only at module level. This means the *declaration context* for an external reference must be a class, structure, or module, and cannot be a source file, namespace, interface, procedure, or block. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). -External references default to [Public](../../../visual-basic/language-reference/modifiers/public.md) access. You can adjust their access levels with the access modifiers. +External references default to [Public](../modifiers/public.md) access. You can adjust their access levels with the access modifiers. ## Rules - **Attributes.** You can apply attributes to an external reference. Any attribute you apply has effect only in your project, not in the external file. -- **Modifiers.** External procedures are implicitly [Shared](../../../visual-basic/language-reference/modifiers/shared.md). You cannot use the `Shared` keyword when declaring an external reference, and you cannot alter its shared status. +- **Modifiers.** External procedures are implicitly [Shared](../modifiers/shared.md). You cannot use the `Shared` keyword when declaring an external reference, and you cannot alter its shared status. An external procedure cannot participate in overriding, implement interface members, or handle events. Accordingly, you cannot use the `Overrides`, `Overridable`, `NotOverridable`, `MustOverride`, `Implements`, or `Handles` keyword in a `Declare` statement. @@ -97,7 +97,7 @@ External references default to [Public](../../../visual-basic/language-reference > [!NOTE] > The Visual Basic compiler does not verify that your data types are compatible with those of the external procedure. If there is a mismatch, the common language runtime generates a exception at run time. -- **Default Data Types.** If `Option Strict` is `Off` and you do not specify the data type of a parameter in `parameterlist`, the Visual Basic compiler converts the corresponding argument to the [Object Data Type](../../../visual-basic/language-reference/data-types/object-data-type.md). Similarly, if you do not specify `returntype`, the compiler takes the return data type to be `Object`. +- **Default Data Types.** If `Option Strict` is `Off` and you do not specify the data type of a parameter in `parameterlist`, the Visual Basic compiler converts the corresponding argument to the [Object Data Type](../data-types/object-data-type.md). Similarly, if you do not specify `returntype`, the compiler takes the return data type to be `Object`. > [!NOTE] > Because you are dealing with an external procedure that might have been written on a different platform, it is dangerous to make any assumptions about data types or to allow them to default. It is much safer to specify the data type of every parameter and of the return value, if any. This also improves the readability of your code. @@ -108,7 +108,7 @@ External references default to [Public](../../../visual-basic/language-reference - **Lifetime.** An external reference has the same lifetime as the class, structure, or module in which it is declared. -- **Calling an External Procedure.** You call an external procedure the same way you call a `Function` or `Sub` procedure—by using it in an expression if it returns a value, or by specifying it in a [Call Statement](../../../visual-basic/language-reference/statements/call-statement.md) if it does not return a value. +- **Calling an External Procedure.** You call an external procedure the same way you call a `Function` or `Sub` procedure—by using it in an expression if it returns a value, or by specifying it in a [Call Statement](call-statement.md) if it does not return a value. You pass arguments to the external procedure exactly as specified by `parameterlist` in the `Declare` statement. Do not take into account how the parameters were originally declared in the external file. Similarly, if there is a return value, use it exactly as specified by `returntype` in the `Declare` statement. @@ -120,7 +120,7 @@ External references default to [Public](../../../visual-basic/language-reference - On a Unicode platform, such as Windows NT, Windows 2000, or Windows XP, first look up the external procedure with no name modification. If that fails, append "W" to the end of the external procedure name and look it up again. -- **Mechanism.** Visual Basic uses the .NET Framework *platform invoke* (PInvoke) mechanism to resolve and access external procedures. The `Declare` statement and the class both use this mechanism automatically, and you do not need any knowledge of PInvoke. For more information, see [Walkthrough: Calling Windows APIs](../../../visual-basic/programming-guide/com-interop/walkthrough-calling-windows-apis.md). +- **Mechanism.** Visual Basic uses the .NET Framework *platform invoke* (PInvoke) mechanism to resolve and access external procedures. The `Declare` statement and the class both use this mechanism automatically, and you do not need any knowledge of PInvoke. For more information, see [Walkthrough: Calling Windows APIs](../../programming-guide/com-interop/walkthrough-calling-windows-apis.md). > [!IMPORTANT] > If the external procedure runs outside the common language runtime (CLR), it is *unmanaged code*. When you call such a procedure, for example a Windows API function or a COM method, you might expose your application to security risks. For more information, see [Secure Coding Guidelines for Unmanaged Code](https://docs.microsoft.com/previous-versions/dotnet/framework/security/secure-coding-guidelines-for-unmanaged-code). @@ -142,10 +142,10 @@ The provides an alterna ## See also - -- [Imports Statement (.NET Namespace and Type)](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md) -- [AddressOf Operator](../../../visual-basic/language-reference/operators/addressof-operator.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md) -- [Call Statement](../../../visual-basic/language-reference/statements/call-statement.md) -- [Walkthrough: Calling Windows APIs](../../../visual-basic/programming-guide/com-interop/walkthrough-calling-windows-apis.md) +- [Imports Statement (.NET Namespace and Type)](imports-statement-net-namespace-and-type.md) +- [AddressOf Operator](../operators/addressof-operator.md) +- [Function Statement](function-statement.md) +- [Sub Statement](sub-statement.md) +- [Parameter List](parameter-list.md) +- [Call Statement](call-statement.md) +- [Walkthrough: Calling Windows APIs](../../programming-guide/com-interop/walkthrough-calling-windows-apis.md) diff --git a/docs/visual-basic/language-reference/statements/delegate-statement.md b/docs/visual-basic/language-reference/statements/delegate-statement.md index 0b3e0163122ad..bcbc5fb430e00 100644 --- a/docs/visual-basic/language-reference/statements/delegate-statement.md +++ b/docs/visual-basic/language-reference/statements/delegate-statement.md @@ -22,14 +22,14 @@ Used to declare a delegate. A delegate is a reference type that refers to a `Sha |Term|Definition| |---|---| -|`attrlist`|Optional. List of attributes that apply to this delegate. Multiple attributes are separated by commas. You must enclose the [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md) in angle brackets ("`<`" and "`>`").| -|`accessmodifier`|Optional. Specifies what code can access the delegate. Can be one of the following:

- [Public](../../../visual-basic/language-reference/modifiers/public.md). Any code that can access the element that declares the delegate can access it.
- [Protected](../../../visual-basic/language-reference/modifiers/protected.md). Only code within the delegate's class or a derived class can access it.
- [Friend](../../../visual-basic/language-reference/modifiers/friend.md). Only code within the same assembly can access the delegate.
- [Private](../../../visual-basic/language-reference/modifiers/private.md). Only code within the element that declares the delegate can access it.

- [Protected Friend](../../language-reference/modifiers/protected-friend.md) Only code within the delegate's class, a derived class, or the same assembly can access the delegate.
- [Private Protected](../../language-reference/modifiers/private-protected.md) Only code within the delegate's class or in a derived class in the same assembly can access the delegate. | +|`attrlist`|Optional. List of attributes that apply to this delegate. Multiple attributes are separated by commas. You must enclose the [Attribute List](attribute-list.md) in angle brackets ("`<`" and "`>`").| +|`accessmodifier`|Optional. Specifies what code can access the delegate. Can be one of the following:

- [Public](../modifiers/public.md). Any code that can access the element that declares the delegate can access it.
- [Protected](../modifiers/protected.md). Only code within the delegate's class or a derived class can access it.
- [Friend](../modifiers/friend.md). Only code within the same assembly can access the delegate.
- [Private](../modifiers/private.md). Only code within the element that declares the delegate can access it.

- [Protected Friend](../modifiers/protected-friend.md) Only code within the delegate's class, a derived class, or the same assembly can access the delegate.
- [Private Protected](../modifiers/private-protected.md) Only code within the delegate's class or in a derived class in the same assembly can access the delegate. | |`Shadows`|Optional. Indicates that this delegate redeclares and hides an identically named programming element, or set of overloaded elements, in a base class. You can shadow any kind of declared element with any other kind.

A shadowed element is unavailable from within the derived class that shadows it, except from where the shadowing element is inaccessible. For example, if a `Private` element shadows a base class element, code that does not have permission to access the `Private` element accesses the base class element instead.| |`Sub`|Optional, but either `Sub` or `Function` must appear. Declares this procedure as a delegate `Sub` procedure that does not return a value.| |`Function`|Optional, but either `Sub` or `Function` must appear. Declares this procedure as a delegate `Function` procedure that returns a value.| |`name`|Required. Name of the delegate type; follows standard variable naming conventions.| -|`typeparamlist`|Optional. List of type parameters for this delegate. Multiple type parameters are separated by commas. Optionally, each type parameter can be declared variant by using `In` and `Out` generic modifiers. You must enclose the [Type List](../../../visual-basic/language-reference/statements/type-list.md) in parentheses and introduce it with the `Of` keyword.| -|`parameterlist`|Optional. List of parameters that are passed to the procedure when it is called. You must enclose the [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md) in parentheses.| +|`typeparamlist`|Optional. List of type parameters for this delegate. Multiple type parameters are separated by commas. Optionally, each type parameter can be declared variant by using `In` and `Out` generic modifiers. You must enclose the [Type List](type-list.md) in parentheses and introduce it with the `Of` keyword.| +|`parameterlist`|Optional. List of parameters that are passed to the procedure when it is called. You must enclose the [Parameter List](parameter-list.md) in parentheses.| |`type`|Required if you specify a `Function` procedure. Data type of the return value.| ## Remarks @@ -49,9 +49,9 @@ Used to declare a delegate. A delegate is a reference type that refers to a `Sha `Function` ([`parm` As `type`, `parm2` As `type2`, ...]) `expression` - The signature of the function must match that of the delegate type. For more information about lambda expressions, see [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md). + The signature of the function must match that of the delegate type. For more information about lambda expressions, see [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md). - For more information about delegates, see [Delegates](../../../visual-basic/programming-guide/language-features/delegates/index.md). + For more information about delegates, see [Delegates](../../programming-guide/language-features/delegates/index.md). ## Example The following example uses the `Delegate` statement to declare a delegate for operating on two numbers and returning a number. The `DelegateTest` method takes an instance of a delegate of this type and uses it to operate on pairs of numbers. @@ -60,11 +60,11 @@ Used to declare a delegate. A delegate is a reference type that refers to a `Sha ## See also -- [AddressOf Operator](../../../visual-basic/language-reference/operators/addressof-operator.md) -- [Of](../../../visual-basic/language-reference/statements/of-clause.md) -- [Delegates](../../../visual-basic/programming-guide/language-features/delegates/index.md) -- [How to: Use a Generic Class](../../../visual-basic/programming-guide/language-features/data-types/how-to-use-a-generic-class.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) +- [AddressOf Operator](../operators/addressof-operator.md) +- [Of](of-clause.md) +- [Delegates](../../programming-guide/language-features/delegates/index.md) +- [How to: Use a Generic Class](../../programming-guide/language-features/data-types/how-to-use-a-generic-class.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) - [Covariance and Contravariance](../../programming-guide/concepts/covariance-contravariance/index.md) -- [In](../../../visual-basic/language-reference/modifiers/in-generic-modifier.md) -- [Out](../../../visual-basic/language-reference/modifiers/out-generic-modifier.md) +- [In](../modifiers/in-generic-modifier.md) +- [Out](../modifiers/out-generic-modifier.md) diff --git a/docs/visual-basic/language-reference/statements/do-loop-statement.md b/docs/visual-basic/language-reference/statements/do-loop-statement.md index abdfa8fe20180..0a2c2cb3be6dc 100644 --- a/docs/visual-basic/language-reference/statements/do-loop-statement.md +++ b/docs/visual-basic/language-reference/statements/do-loop-statement.md @@ -58,21 +58,21 @@ Loop { While | Until } condition |`Loop`|Required. Terminates the definition of the `Do` loop.| ## Remarks - Use a `Do...Loop` structure when you want to repeat a set of statements an indefinite number of times, until a condition is satisfied. If you want to repeat the statements a set number of times, the [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) is usually a better choice. + Use a `Do...Loop` structure when you want to repeat a set of statements an indefinite number of times, until a condition is satisfied. If you want to repeat the statements a set number of times, the [For...Next Statement](for-next-statement.md) is usually a better choice. You can use either `While` or `Until` to specify `condition`, but not both. You can test `condition` only one time, at either the start or the end of the loop. If you test `condition` at the start of the loop (in the `Do` statement), the loop might not run even one time. If you test at the end of the loop (in the `Loop` statement), the loop always runs at least one time. - The condition usually results from a comparison of two values, but it can be any expression that evaluates to a [Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md) value (`True` or `False`). This includes values of other data types, such as numeric types, that have been converted to `Boolean`. + The condition usually results from a comparison of two values, but it can be any expression that evaluates to a [Boolean Data Type](../data-types/boolean-data-type.md) value (`True` or `False`). This includes values of other data types, such as numeric types, that have been converted to `Boolean`. - You can nest `Do` loops by putting one loop within another. You can also nest different kinds of control structures within each other. For more information, see [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md). + You can nest `Do` loops by putting one loop within another. You can also nest different kinds of control structures within each other. For more information, see [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md). > [!NOTE] -> The `Do...Loop` structure gives you more flexibility than the [While...End While Statement](../../../visual-basic/language-reference/statements/while-end-while-statement.md) because it enables you to decide whether to end the loop when `condition` stops being `True` or when it first becomes `True`. It also enables you to test `condition` at either the start or the end of the loop. +> The `Do...Loop` structure gives you more flexibility than the [While...End While Statement](while-end-while-statement.md) because it enables you to decide whether to end the loop when `condition` stops being `True` or when it first becomes `True`. It also enables you to test `condition` at either the start or the end of the loop. ## Exit Do - The [Exit Do](../../../visual-basic/language-reference/statements/exit-statement.md) statement can provide an alternative way to exit a `Do…Loop`. `Exit Do` transfers control immediately to the statement that follows the `Loop` statement. + The [Exit Do](exit-statement.md) statement can provide an alternative way to exit a `Do…Loop`. `Exit Do` transfers control immediately to the statement that follows the `Loop` statement. `Exit Do` is often used after some condition is evaluated, for example in an `If...Then...Else` structure. You might want to exit a loop if you detect a condition that makes it unnecessary or impossible to continue iterating, such as an erroneous value or a termination request. One use of `Exit Do` is to test for a condition that could cause an *endless loop*, which is a loop that could run a large or even infinite number of times. You can use `Exit Do` to escape the loop. @@ -102,9 +102,9 @@ Loop { While | Until } condition ## See also -- [Loop Structures](../../../visual-basic/programming-guide/language-features/control-flow/loop-structures.md) -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md) -- [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md) -- [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md) -- [While...End While Statement](../../../visual-basic/language-reference/statements/while-end-while-statement.md) +- [Loop Structures](../../programming-guide/language-features/control-flow/loop-structures.md) +- [For...Next Statement](for-next-statement.md) +- [Boolean Data Type](../data-types/boolean-data-type.md) +- [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md) +- [Exit Statement](exit-statement.md) +- [While...End While Statement](while-end-while-statement.md) diff --git a/docs/visual-basic/language-reference/statements/else-statement.md b/docs/visual-basic/language-reference/statements/else-statement.md index 4e495734cb482..f78403a0f6dd1 100644 --- a/docs/visual-basic/language-reference/statements/else-statement.md +++ b/docs/visual-basic/language-reference/statements/else-statement.md @@ -13,12 +13,12 @@ Introduces a group of statements to be run or compiled if no other conditional g ## Remarks The `Else` keyword can be used in these contexts: - [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) + [If...Then...Else Statement](if-then-else-statement.md) - [Select...Case Statement](../../../visual-basic/language-reference/statements/select-case-statement.md) + [Select...Case Statement](select-case-statement.md) - [#If...Then...#Else Directive](../../../visual-basic/language-reference/directives/if-then-else-directives.md) + [#If...Then...#Else Directive](../directives/if-then-else-directives.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/statements/end-statement.md b/docs/visual-basic/language-reference/statements/end-statement.md index 83ed221d6a09a..c8d029ed5e53f 100644 --- a/docs/visual-basic/language-reference/statements/end-statement.md +++ b/docs/visual-basic/language-reference/statements/end-statement.md @@ -34,12 +34,12 @@ End Because `End` terminates your application without attending to any resources that might be open, you should try to close down cleanly before using it. For example, if your application has any forms open, you should close them before control reaches the `End` statement. - You should use `End` sparingly, and only when you need to stop immediately. The normal ways to terminate a procedure ([Return Statement](../../../visual-basic/language-reference/statements/return-statement.md) and [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md)) not only close down the procedure cleanly but also give the calling code the opportunity to close down cleanly. A console application, for example, can simply `Return` from the `Main` procedure. + You should use `End` sparingly, and only when you need to stop immediately. The normal ways to terminate a procedure ([Return Statement](return-statement.md) and [Exit Statement](exit-statement.md)) not only close down the procedure cleanly but also give the calling code the opportunity to close down cleanly. A console application, for example, can simply `Return` from the `Main` procedure. > [!IMPORTANT] > The `End` statement calls the method of the class in the namespace. requires that you have `UnmanagedCode` permission. If you do not, a error occurs. - When followed by an additional keyword, [End \ Statement](../../../visual-basic/language-reference/statements/end-keyword-statement.md) delineates the end of the definition of the appropriate procedure or block. For example, `End Function` terminates the definition of a `Function` procedure. + When followed by an additional keyword, [End \ Statement](end-keyword-statement.md) delineates the end of the definition of the appropriate procedure or block. For example, `End Function` terminates the definition of a `Function` procedure. ## Example The following example uses the `End` statement to terminate code execution if the user requests it. @@ -52,5 +52,5 @@ End ## See also - -- [Stop Statement](../../../visual-basic/language-reference/statements/stop-statement.md) -- [End \ Statement](../../../visual-basic/language-reference/statements/end-keyword-statement.md) +- [Stop Statement](stop-statement.md) +- [End \ Statement](end-keyword-statement.md) diff --git a/docs/visual-basic/language-reference/statements/enum-statement.md b/docs/visual-basic/language-reference/statements/enum-statement.md index 3b7c9eab375bd..477c30254cd49 100644 --- a/docs/visual-basic/language-reference/statements/enum-statement.md +++ b/docs/visual-basic/language-reference/statements/enum-statement.md @@ -29,7 +29,7 @@ End Enum - `attributelist` - Optional. List of attributes that apply to this enumeration. You must enclose the [attribute list](../../../visual-basic/language-reference/statements/attribute-list.md) in angle brackets ("`<`" and "`>`"). + Optional. List of attributes that apply to this enumeration. You must enclose the [attribute list](attribute-list.md) in angle brackets ("`<`" and "`>`"). The attribute indicates that the value of an instance of the enumeration can include multiple enumeration members, and that each member represents a bit field in the enumeration value. @@ -37,25 +37,25 @@ End Enum Optional. Specifies what code can access this enumeration. Can be one of the following: - - [Public](../../../visual-basic/language-reference/modifiers/public.md) + - [Public](../modifiers/public.md) - - [Protected](../../../visual-basic/language-reference/modifiers/protected.md) + - [Protected](../modifiers/protected.md) - - [Friend](../../../visual-basic/language-reference/modifiers/friend.md) + - [Friend](../modifiers/friend.md) - - [Private](../../../visual-basic/language-reference/modifiers/private.md) + - [Private](../modifiers/private.md) - - [Protected Friend](../../language-reference/modifiers/protected-friend.md) + - [Protected Friend](../modifiers/protected-friend.md) - - [Private Protected](../../language-reference/modifiers/private-protected.md) + - [Private Protected](../modifiers/private-protected.md) - `Shadows` - Optional. Specifies that this enumeration redeclares and hides an identically named programming element, or set of overloaded elements, in a base class. You can specify [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) only on the enumeration itself, not on any of its members. + Optional. Specifies that this enumeration redeclares and hides an identically named programming element, or set of overloaded elements, in a base class. You can specify [Shadows](../modifiers/shadows.md) only on the enumeration itself, not on any of its members. - `enumerationname` - Required. Name of the enumeration. For information on valid names, see [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). + Required. Name of the enumeration. For information on valid names, see [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). - `datatype` @@ -94,11 +94,11 @@ An enumeration has a name, an underlying data type, and a set of members. Each m An enumeration declared at class, structure, module, or interface level, outside any procedure, is a *member enumeration*. It is a member of the class, structure, module, or interface that declares it. -Member enumerations can be accessed from anywhere within their class, structure, module, or interface. Code outside a class, structure, or module must qualify a member enumeration's name with the name of that class, structure, or module. You can avoid the need to use fully qualified names by adding an [Imports](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md) statement to the source file. +Member enumerations can be accessed from anywhere within their class, structure, module, or interface. Code outside a class, structure, or module must qualify a member enumeration's name with the name of that class, structure, or module. You can avoid the need to use fully qualified names by adding an [Imports](imports-statement-net-namespace-and-type.md) statement to the source file. An enumeration declared at namespace level, outside any class, structure, module, or interface, is a member of the namespace in which it appears. -The *declaration context* for an enumeration must be a source file, namespace, class, structure, module, or interface, and cannot be a procedure. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). +The *declaration context* for an enumeration must be a source file, namespace, class, structure, module, or interface, and cannot be a procedure. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). You can apply attributes to an enumeration as a whole, but not to its members individually. An attribute contributes information to the assembly's metadata. @@ -124,7 +124,7 @@ If the value of a member exceeds the allowable range for the underlying data typ ## Modifiers -Class, structure, module, and interface member enumerations default to public access. You can adjust their access levels with the access modifiers. Namespace member enumerations default to friend access. You can adjust their access levels to public, but not to private or protected. For more information, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +Class, structure, module, and interface member enumerations default to public access. You can adjust their access levels with the access modifiers. Namespace member enumerations default to friend access. You can adjust their access levels to public, but not to private or protected. For more information, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). All enumeration members have public access, and you cannot use any access modifiers on them. However, if the enumeration itself has a more restricted access level, the specified enumeration access level takes precedence. @@ -182,8 +182,8 @@ The following example iterates through an enumeration. It uses the - -- [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [Constants and Enumerations](../../../visual-basic/language-reference/constants-and-enumerations.md) +- [Const Statement](const-statement.md) +- [Dim Statement](dim-statement.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [Constants and Enumerations](../constants-and-enumerations.md) diff --git a/docs/visual-basic/language-reference/statements/erase-statement.md b/docs/visual-basic/language-reference/statements/erase-statement.md index 35b9330745a87..e32fb5f62982b 100644 --- a/docs/visual-basic/language-reference/statements/erase-statement.md +++ b/docs/visual-basic/language-reference/statements/erase-statement.md @@ -33,5 +33,5 @@ Erase arraylist ## See also -- [Nothing](../../../visual-basic/language-reference/nothing.md) -- [ReDim Statement](../../../visual-basic/language-reference/statements/redim-statement.md) +- [Nothing](../nothing.md) +- [ReDim Statement](redim-statement.md) diff --git a/docs/visual-basic/language-reference/statements/error-statement.md b/docs/visual-basic/language-reference/statements/error-statement.md index f79c6e30b5cd9..9929dc087f6b8 100644 --- a/docs/visual-basic/language-reference/statements/error-statement.md +++ b/docs/visual-basic/language-reference/statements/error-statement.md @@ -52,7 +52,7 @@ Error 11 ' Simulate the "Division by zero" error. ``` ## Requirements - **Namespace:** [Microsoft.VisualBasic](../../../visual-basic/language-reference/runtime-library-members.md) + **Namespace:** [Microsoft.VisualBasic](../runtime-library-members.md) **Assembly:** Visual Basic Runtime Library (in Microsoft.VisualBasic.dll) @@ -61,6 +61,6 @@ Error 11 ' Simulate the "Division by zero" error. - - - -- [On Error Statement](../../../visual-basic/language-reference/statements/on-error-statement.md) -- [Resume Statement](../../../visual-basic/language-reference/statements/resume-statement.md) -- [Error Messages](../../../visual-basic/language-reference/error-messages/index.md) +- [On Error Statement](on-error-statement.md) +- [Resume Statement](resume-statement.md) +- [Error Messages](../error-messages/index.md) diff --git a/docs/visual-basic/language-reference/statements/event-statement.md b/docs/visual-basic/language-reference/statements/event-statement.md index e47a5345fa603..ec2d2078ce2f2 100644 --- a/docs/visual-basic/language-reference/statements/event-statement.md +++ b/docs/visual-basic/language-reference/statements/event-statement.md @@ -52,12 +52,12 @@ End Event |Part|Description| |---|---| -|`attrlist`|Optional. List of attributes that apply to this event. Multiple attributes are separated by commas. You must enclose the [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md) in angle brackets ("`<`" and "`>`").| -|`accessmodifier`|Optional. Specifies what code can access the event. Can be one of the following:

- [Public](../../../visual-basic/language-reference/modifiers/public.md)—any code that can access the element that declares it can access it.
- [Protected](../../../visual-basic/language-reference/modifiers/protected.md)—only code within its class or a derived class can access it.
- [Friend](../../../visual-basic/language-reference/modifiers/friend.md)—only code in the same assembly can access it.
- [Private](../../../visual-basic/language-reference/modifiers/private.md)—only code in the element that declares it can access it.
- [Protected Friend](../../language-reference/modifiers/protected-friend.md)-only code in the event's class, a derived class, or the same assembly can access it.
- [Private Protected](../../language-reference/modifiers/private-protected.md)-only code in the event's class or a derived class in the same assembly can access it.| +|`attrlist`|Optional. List of attributes that apply to this event. Multiple attributes are separated by commas. You must enclose the [Attribute List](attribute-list.md) in angle brackets ("`<`" and "`>`").| +|`accessmodifier`|Optional. Specifies what code can access the event. Can be one of the following:

- [Public](../modifiers/public.md)—any code that can access the element that declares it can access it.
- [Protected](../modifiers/protected.md)—only code within its class or a derived class can access it.
- [Friend](../modifiers/friend.md)—only code in the same assembly can access it.
- [Private](../modifiers/private.md)—only code in the element that declares it can access it.
- [Protected Friend](../modifiers/protected-friend.md)-only code in the event's class, a derived class, or the same assembly can access it.
- [Private Protected](../modifiers/private-protected.md)-only code in the event's class or a derived class in the same assembly can access it.| |`Shared`|Optional. Specifies that this event is not associated with a specific instance of a class or structure.| |`Shadows`|Optional. Indicates that this event redeclares and hides an identically named programming element, or set of overloaded elements, in a base class. You can shadow any kind of declared element with any other kind.

A shadowed element is unavailable from within the derived class that shadows it, except from where the shadowing element is inaccessible. For example, if a `Private` element shadows a base-class element, code that does not have permission to access the `Private` element accesses the base-class element instead.| |`eventname`|Required. Name of the event; follows standard variable naming conventions.| -|`parameterlist`|Optional. List of local variables that represent the parameters of this event. You must enclose the [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md) in parentheses.| +|`parameterlist`|Optional. List of local variables that represent the parameters of this event. You must enclose the [Parameter List](parameter-list.md) in parentheses.| |`Implements`|Optional. Indicates that this event implements an event of an interface.| |`implementslist`|Required if `Implements` is supplied. List of `Sub` procedures being implemented. Multiple procedures are separated by commas:

*implementedprocedure* [ , *implementedprocedure* ... ]

Each `implementedprocedure` has the following syntax and parts:

`interface`.`definedname`

- `interface` - Required. Name of an interface that this procedure's containing class or structure is implementing.
- `Definedname` - Required. Name by which the procedure is defined in `interface`. This does not have to be the same as `name`, the name that this procedure is using to implement the defined procedure.| |`Custom`|Required. Events declared as `Custom` must define custom `AddHandler`, `RemoveHandler`, and `RaiseEvent` accessors.| @@ -69,7 +69,7 @@ End Event |`End RemoveHandler`|Required. Terminates the `RemoveHandler` block.| |`RaiseEvent`|Required. Declares a `RaiseEvent` accessor, which specifies the statements to execute when the event is raised using the `RaiseEvent` statement. Typically, this invokes a list of delegates maintained by the `AddHandler` and `RemoveHandler` accessors.| |`End RaiseEvent`|Required. Terminates the `RaiseEvent` block.| -|`delegatesignature`|Required. List of parameters that matches the parameters required by the `delegatename` delegate. You must enclose the [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md) in parentheses.| +|`delegatesignature`|Required. List of parameters that matches the parameters required by the `delegatename` delegate. You must enclose the [Parameter List](parameter-list.md) in parentheses.| |`statements`|Optional. Statements that contain the bodies of the `AddHandler`, `RemoveHandler`, and `RaiseEvent` methods.| |`End Event`|Required. Terminates the `Event` block.| @@ -83,9 +83,9 @@ End Event To handle an event, you must associate it with an event handler subroutine using either the `Handles` or `AddHandler` statement. The signatures of the subroutine and the event must match. To handle a shared event, you must use the `AddHandler` statement. - You can use `Event` only at module level. This means the *declaration context* for an event must be a class, structure, module, or interface, and cannot be a source file, namespace, procedure, or block. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). + You can use `Event` only at module level. This means the *declaration context* for an event must be a class, structure, module, or interface, and cannot be a source file, namespace, procedure, or block. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). - In most circumstances, you can use the first syntax in the Syntax section of this topic for declaring events. However, some scenarios require that you have more control over the detailed behavior of the event. The last syntax in the Syntax section of this topic, which uses the `Custom` keyword, provides that control by enabling you to define custom events. In a custom event, you specify exactly what occurs when code adds or removes an event handler to or from the event, or when code raises the event. For examples, see [How to: Declare Custom Events To Conserve Memory](../../../visual-basic/programming-guide/language-features/events/how-to-declare-custom-events-to-conserve-memory.md) and [How to: Declare Custom Events To Avoid Blocking](../../../visual-basic/programming-guide/language-features/events/how-to-declare-custom-events-to-avoid-blocking.md). + In most circumstances, you can use the first syntax in the Syntax section of this topic for declaring events. However, some scenarios require that you have more control over the detailed behavior of the event. The last syntax in the Syntax section of this topic, which uses the `Custom` keyword, provides that control by enabling you to define custom events. In a custom event, you specify exactly what occurs when code adds or removes an event handler to or from the event, or when code raises the event. For examples, see [How to: Declare Custom Events To Conserve Memory](../../programming-guide/language-features/events/how-to-declare-custom-events-to-conserve-memory.md) and [How to: Declare Custom Events To Avoid Blocking](../../programming-guide/language-features/events/how-to-declare-custom-events-to-avoid-blocking.md). ## Example The following example uses events to count down seconds from 10 to 0. The code illustrates several of the event-related methods, properties, and statements. This includes the `RaiseEvent` statement. @@ -113,14 +113,14 @@ End Event ## See also -- [RaiseEvent Statement](../../../visual-basic/language-reference/statements/raiseevent-statement.md) -- [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) -- [AddHandler Statement](../../../visual-basic/language-reference/statements/addhandler-statement.md) -- [RemoveHandler Statement](../../../visual-basic/language-reference/statements/removehandler-statement.md) -- [Handles](../../../visual-basic/language-reference/statements/handles-clause.md) -- [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) -- [How to: Declare Custom Events To Conserve Memory](../../../visual-basic/programming-guide/language-features/events/how-to-declare-custom-events-to-conserve-memory.md) -- [How to: Declare Custom Events To Avoid Blocking](../../../visual-basic/programming-guide/language-features/events/how-to-declare-custom-events-to-avoid-blocking.md) -- [Shared](../../../visual-basic/language-reference/modifiers/shared.md) -- [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md) +- [RaiseEvent Statement](raiseevent-statement.md) +- [Implements Statement](implements-statement.md) +- [Events](../../programming-guide/language-features/events/index.md) +- [AddHandler Statement](addhandler-statement.md) +- [RemoveHandler Statement](removehandler-statement.md) +- [Handles](handles-clause.md) +- [Delegate Statement](delegate-statement.md) +- [How to: Declare Custom Events To Conserve Memory](../../programming-guide/language-features/events/how-to-declare-custom-events-to-conserve-memory.md) +- [How to: Declare Custom Events To Avoid Blocking](../../programming-guide/language-features/events/how-to-declare-custom-events-to-avoid-blocking.md) +- [Shared](../modifiers/shared.md) +- [Shadows](../modifiers/shadows.md) diff --git a/docs/visual-basic/language-reference/statements/f-p-statements.md b/docs/visual-basic/language-reference/statements/f-p-statements.md index dfb9b723c6726..515b5458f324d 100644 --- a/docs/visual-basic/language-reference/statements/f-p-statements.md +++ b/docs/visual-basic/language-reference/statements/f-p-statements.md @@ -8,15 +8,15 @@ The following table contains a listing of Visual Basic language statements. ||||| |---|---|---|---| -|[For Each...Next](../../../visual-basic/language-reference/statements/for-each-next-statement.md)|[For...Next](../../../visual-basic/language-reference/statements/for-next-statement.md)|[Function](../../../visual-basic/language-reference/statements/function-statement.md)|[Get](../../../visual-basic/language-reference/statements/get-statement.md)| -|[GoTo](../../../visual-basic/language-reference/statements/goto-statement.md)|[If...Then...Else](../../../visual-basic/language-reference/statements/if-then-else-statement.md)|[Implements](../../../visual-basic/language-reference/statements/implements-statement.md)|[Imports (.NET Namespace and Type)](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md)| -|[Imports (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md)|[Inherits](../../../visual-basic/language-reference/statements/inherits-statement.md)|[Interface](../../../visual-basic/language-reference/statements/interface-statement.md)|[Mid](../../../visual-basic/language-reference/statements/mid-statement.md)| -|[Module](../../../visual-basic/language-reference/statements/module-statement.md)|[Namespace](../../../visual-basic/language-reference/statements/namespace-statement.md)|[On Error](../../../visual-basic/language-reference/statements/on-error-statement.md)|[Operator](../../../visual-basic/language-reference/statements/operator-statement.md)| -|[Option \](../../../visual-basic/language-reference/statements/option-keyword-statement.md)|[Option Compare](../../../visual-basic/language-reference/statements/option-compare-statement.md)|[Option Explicit](../../../visual-basic/language-reference/statements/option-explicit-statement.md)|[Option Infer](../../../visual-basic/language-reference/statements/option-infer-statement.md)| -|[Option Strict](../../../visual-basic/language-reference/statements/option-strict-statement.md)|[Property](../../../visual-basic/language-reference/statements/property-statement.md)||| +|[For Each...Next](for-each-next-statement.md)|[For...Next](for-next-statement.md)|[Function](function-statement.md)|[Get](get-statement.md)| +|[GoTo](goto-statement.md)|[If...Then...Else](if-then-else-statement.md)|[Implements](implements-statement.md)|[Imports (.NET Namespace and Type)](imports-statement-net-namespace-and-type.md)| +|[Imports (XML Namespace)](imports-statement-xml-namespace.md)|[Inherits](inherits-statement.md)|[Interface](interface-statement.md)|[Mid](mid-statement.md)| +|[Module](module-statement.md)|[Namespace](namespace-statement.md)|[On Error](on-error-statement.md)|[Operator](operator-statement.md)| +|[Option \](option-keyword-statement.md)|[Option Compare](option-compare-statement.md)|[Option Explicit](option-explicit-statement.md)|[Option Infer](option-infer-statement.md)| +|[Option Strict](option-strict-statement.md)|[Property](property-statement.md)||| ## See also -- [A-E Statements](../../../visual-basic/language-reference/statements/a-e-statements.md) -- [Q-Z Statements](../../../visual-basic/language-reference/statements/q-z-statements.md) -- [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) +- [A-E Statements](a-e-statements.md) +- [Q-Z Statements](q-z-statements.md) +- [Visual Basic Language Reference](../index.md) diff --git a/docs/visual-basic/language-reference/statements/for-each-next-statement.md b/docs/visual-basic/language-reference/statements/for-each-next-statement.md index 32a1fa30c2d60..d67f39cd35bd7 100644 --- a/docs/visual-basic/language-reference/statements/for-each-next-statement.md +++ b/docs/visual-basic/language-reference/statements/for-each-next-statement.md @@ -56,13 +56,13 @@ Next [ element ] Use a `For Each`...`Next` loop when you want to repeat a set of statements for each element of a collection or array. > [!TIP] -> A [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) works well when you can associate each iteration of a loop with a control variable and determine that variable's initial and final values. However, when you are dealing with a collection, the concept of initial and final values isn't meaningful, and you don't necessarily know how many elements the collection has. In this kind of case, a `For Each`...`Next` loop is often a better choice. +> A [For...Next Statement](for-next-statement.md) works well when you can associate each iteration of a loop with a control variable and determine that variable's initial and final values. However, when you are dealing with a collection, the concept of initial and final values isn't meaningful, and you don't necessarily know how many elements the collection has. In this kind of case, a `For Each`...`Next` loop is often a better choice. In the following example, the `For Each`…`Next` statement iterates through all the elements of a List collection. [!code-vb[VbVbalrStatements#121](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/class9.vb#121)] -For more examples, see [Collections](../../../standard/collections/index.md) and [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md). +For more examples, see [Collections](../../../standard/collections/index.md) and [Arrays](../../programming-guide/language-features/arrays/index.md). ## Nested Loops @@ -74,13 +74,13 @@ The following example demonstrates nested `For Each`…`Next` structures. When you nest loops, each loop must have a unique `element` variable. -You can also nest different kinds of control structures within each other. For more information, see [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md). +You can also nest different kinds of control structures within each other. For more information, see [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md). ## Exit For and Continue For -The [Exit For](../../../visual-basic/language-reference/statements/exit-statement.md) statement causes execution to exit the `For`…`Next` loop and transfers control to the statement that follows the `Next` statement. +The [Exit For](exit-statement.md) statement causes execution to exit the `For`…`Next` loop and transfers control to the statement that follows the `Next` statement. -The `Continue For` statement transfers control immediately to the next iteration of the loop. For more information, see [Continue Statement](../../../visual-basic/language-reference/statements/continue-statement.md). +The `Continue For` statement transfers control immediately to the next iteration of the loop. For more information, see [Continue Statement](continue-statement.md). The following example shows how to use the `Continue For` and `Exit For` statements. @@ -94,7 +94,7 @@ You can put any number of `Exit For` statements in a `For Each` loop. When used - An exception is caught in a `Try`...`Catch`...`Finally`. You might use `Exit For` at the end of the `Finally` block. -- There an endless loop, which is a loop that could run a large or even infinite number of times. If you detect such a condition, you can use `Exit For` to escape the loop. For more information, see [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md). +- There an endless loop, which is a loop that could run a large or even infinite number of times. If you detect such a condition, you can use `Exit For` to escape the loop. For more information, see [Do...Loop Statement](do-loop-statement.md). ## Iterators @@ -102,11 +102,11 @@ You use an *iterator* to perform a custom iteration over a collection. An iterat You call an iterator by using a `For Each...Next` statement. Each iteration of the `For Each` loop calls the iterator. When a `Yield` statement is reached in the iterator, the expression in the `Yield` statement is returned, and the current location in code is retained. Execution is restarted from that location the next time that the iterator is called. -The following example uses an iterator function. The iterator function has a `Yield` statement that's inside a [For…Next](../../../visual-basic/language-reference/statements/for-next-statement.md) loop. In the `ListEvenNumbers` method, each iteration of the `For Each` statement body creates a call to the iterator function, which proceeds to the next `Yield` statement. +The following example uses an iterator function. The iterator function has a `Yield` statement that's inside a [For…Next](for-next-statement.md) loop. In the `ListEvenNumbers` method, each iteration of the `For Each` statement body creates a call to the iterator function, which proceeds to the next `Yield` statement. [!code-vb[VbVbalrStatements#127](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/class9.vb#127)] -For more information, see [Iterators](../../programming-guide/concepts/iterators.md), [Yield Statement](../../../visual-basic/language-reference/statements/yield-statement.md), and [Iterator](../../../visual-basic/language-reference/modifiers/iterator.md). +For more information, see [Iterators](../../programming-guide/concepts/iterators.md), [Yield Statement](yield-statement.md), and [Iterator](../modifiers/iterator.md). ## Technical Implementation @@ -146,7 +146,7 @@ Each time Visual Basic encounters the `Next` statement, it returns to the `For E However, this blocking of modification isn't determined by Visual Basic, but rather by the implementation of the interface. It is possible to implement `IEnumerable` in a way that allows for modification during iteration. If you are considering doing such dynamic modification, make sure that you understand the characteristics of the `IEnumerable` implementation on the collection you are using. -**Modifying Collection Elements.** The property of the enumerator object is [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md), and it returns a local copy of each collection element. This means that you cannot modify the elements themselves in a `For Each`...`Next` loop. Any modification you make affects only the local copy from `Current` and isn't reflected back into the underlying collection. However, if an element is a reference type, you can modify the members of the instance to which it points. The following example modifies the `BackColor` member of each `thisControl` element. You cannot, however, modify `thisControl` itself. +**Modifying Collection Elements.** The property of the enumerator object is [ReadOnly](../modifiers/readonly.md), and it returns a local copy of each collection element. This means that you cannot modify the elements themselves in a `For Each`...`Next` loop. Any modification you make affects only the local copy from `Current` and isn't reflected back into the underlying collection. However, if an element is a reference type, you can modify the members of the instance to which it points. The following example modifies the `BackColor` member of each `thisControl` element. You cannot, however, modify `thisControl` itself. ```vb Sub LightBlueBackground(thisForm As System.Windows.Forms.Form) @@ -179,11 +179,11 @@ In the `ListCars` method, the `cars.Sort()` statement sorts the list. This call ## See also - [Collections](../../../standard/collections/index.md) -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [Loop Structures](../../../visual-basic/programming-guide/language-features/control-flow/loop-structures.md) -- [While...End While Statement](../../../visual-basic/language-reference/statements/while-end-while-statement.md) -- [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md) -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) -- [Object Initializers: Named and Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) -- [Collection Initializers](../../../visual-basic/programming-guide/language-features/collection-initializers/index.md) -- [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md) +- [For...Next Statement](for-next-statement.md) +- [Loop Structures](../../programming-guide/language-features/control-flow/loop-structures.md) +- [While...End While Statement](while-end-while-statement.md) +- [Do...Loop Statement](do-loop-statement.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [Object Initializers: Named and Anonymous Types](../../programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) +- [Collection Initializers](../../programming-guide/language-features/collection-initializers/index.md) +- [Arrays](../../programming-guide/language-features/arrays/index.md) diff --git a/docs/visual-basic/language-reference/statements/for-next-statement.md b/docs/visual-basic/language-reference/statements/for-next-statement.md index dbbb29721673c..776c02f7d695f 100644 --- a/docs/visual-basic/language-reference/statements/for-next-statement.md +++ b/docs/visual-basic/language-reference/statements/for-next-statement.md @@ -55,7 +55,7 @@ Next [ counter ] |`Next`|Required. Terminates the definition of the `For` loop.| > [!NOTE] -> The `To` keyword is used in this statement to specify the range for the counter. You can also use this keyword in the [Select...Case Statement](../../../visual-basic/language-reference/statements/select-case-statement.md) and in array declarations. For more information about array declarations, see [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md). +> The `To` keyword is used in this statement to specify the range for the counter. You can also use this keyword in the [Select...Case Statement](select-case-statement.md) and in array declarations. For more information about array declarations, see [Dim Statement](dim-statement.md). ## Simple Examples @@ -70,7 +70,7 @@ In the following example, the `number` variable starts at 2 and is reduced by 0. [!code-vb[VbVbalrStatements#112](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/class7.vb#112)] > [!TIP] -> A [While...End While Statement](../../../visual-basic/language-reference/statements/while-end-while-statement.md) or [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md) works well when you don't know in advance how many times to run the statements in the loop. However, when you expect to run the loop a specific number of times, a `For`...`Next` loop is a better choice. You determine the number of iterations when you first enter the loop. +> A [While...End While Statement](while-end-while-statement.md) or [Do...Loop Statement](do-loop-statement.md) works well when you don't know in advance how many times to run the statements in the loop. However, when you expect to run the loop a specific number of times, a `For`...`Next` loop is a better choice. You determine the number of iterations when you first enter the loop. ## Nesting Loops @@ -80,13 +80,13 @@ You can nest `For` loops by putting one loop within another. The following examp When nesting loops, each loop must have a unique `counter` variable. -You can also nest different kinds control structures within each other. For more information, see [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md). +You can also nest different kinds control structures within each other. For more information, see [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md). ## Exit For and Continue For The `Exit For` statement immediately exits the `For`…`Next` loop and transfers control to the statement that follows the `Next` statement. -The `Continue For` statement transfers control immediately to the next iteration of the loop. For more information, see [Continue Statement](../../../visual-basic/language-reference/statements/continue-statement.md). +The `Continue For` statement transfers control immediately to the next iteration of the loop. For more information, see [Continue Statement](continue-statement.md). The following example illustrates the use of the `Continue For` and `Exit For` statements. @@ -100,7 +100,7 @@ You can put any number of `Exit For` statements in a `For`…`Next` loop. When u - A `Try`...`Catch`...`Finally` statement catches an exception. You might use `Exit For` at the end of the `Finally` block. -- You have an endless loop, which is a loop that could run a large or even infinite number of times. If you detect such a condition, you can use `Exit For` to escape the loop. For more information, see [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md). +- You have an endless loop, which is a loop that could run a large or even infinite number of times. If you detect such a condition, you can use `Exit For` to escape the loop. For more information, see [Do...Loop Statement](do-loop-statement.md). ## Technical Implementation @@ -132,7 +132,7 @@ The following table indicates whether `counter` defines a new local variable tha |Is `datatype` present?|Is `counter` already defined?|Result (whether `counter` defines a new local variable that’s scoped to the entire `For...Next` loop)| |----------------------------|-----------------------------------|-------------------------------------------------------------------------------------------------------------| |No|Yes|No, because `counter` is already defined. If the scope of `counter` isn't local to the procedure, a compile-time warning occurs.| -|No|No|Yes. The data type is inferred from the `start`, `end`, and `step` expressions. For information about type inference, see [Option Infer Statement](../../../visual-basic/language-reference/statements/option-infer-statement.md) and [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md).| +|No|No|Yes. The data type is inferred from the `start`, `end`, and `step` expressions. For information about type inference, see [Option Infer Statement](option-infer-statement.md) and [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md).| |Yes|Yes|Yes, but only if the existing `counter` variable is defined outside the procedure. That variable remains separate. If the scope of the existing `counter` variable is local to the procedure, a compile-time error occurs.| |Yes|No|Yes.| @@ -140,7 +140,7 @@ The data type of `counter` determines the type of the iteration, which must be o - A `Byte`, `SByte`, `UShort`, `Short`, `UInteger`, `Integer`, `ULong`, `Long`, `Decimal`, `Single`, or `Double`. -- An enumeration that you declare by using an [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md). +- An enumeration that you declare by using an [Enum Statement](enum-statement.md). - An `Object`. @@ -160,13 +160,13 @@ The `start`, `end`, and `step` expressions can evaluate to any data type that wi ## Example -The following example removes all elements from a generic list. Instead of a [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md), the example shows a `For`...`Next` statement that iterates in descending order. The example uses this technique because the `removeAt` method causes elements after the removed element to have a lower index value. +The following example removes all elements from a generic list. Instead of a [For Each...Next Statement](for-each-next-statement.md), the example shows a `For`...`Next` statement that iterates in descending order. The example uses this technique because the `removeAt` method causes elements after the removed element to have a lower index value. [!code-vb[VbVbalrStatements#114](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/class7.vb#114)] ## Example -The following example iterates through an enumeration that's declared by using an [Enum Statement](../../../visual-basic/language-reference/statements/enum-statement.md). +The following example iterates through an enumeration that's declared by using an [Enum Statement](enum-statement.md). [!code-vb[VbVbalrStatements#116](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStatements/VB/class7.vb#116)] @@ -179,9 +179,9 @@ In the following example, the statement parameters use a class that has operator ## See also - -- [Loop Structures](../../../visual-basic/programming-guide/language-features/control-flow/loop-structures.md) -- [While...End While Statement](../../../visual-basic/language-reference/statements/while-end-while-statement.md) -- [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md) -- [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md) -- [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md) +- [Loop Structures](../../programming-guide/language-features/control-flow/loop-structures.md) +- [While...End While Statement](while-end-while-statement.md) +- [Do...Loop Statement](do-loop-statement.md) +- [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md) +- [Exit Statement](exit-statement.md) - [Collections](../../programming-guide/concepts/collections.md) diff --git a/docs/visual-basic/language-reference/statements/function-statement.md b/docs/visual-basic/language-reference/statements/function-statement.md index 59dc9d79e53a2..5a1fb9a5a457f 100644 --- a/docs/visual-basic/language-reference/statements/function-statement.md +++ b/docs/visual-basic/language-reference/statements/function-statement.md @@ -54,33 +54,33 @@ End Function Optional. Can be one of the following: - - [Public](../../../visual-basic/language-reference/modifiers/public.md) + - [Public](../modifiers/public.md) - - [Protected](../../../visual-basic/language-reference/modifiers/protected.md) + - [Protected](../modifiers/protected.md) - - [Friend](../../../visual-basic/language-reference/modifiers/friend.md) + - [Friend](../modifiers/friend.md) - - [Private](../../../visual-basic/language-reference/modifiers/private.md) + - [Private](../modifiers/private.md) - - [Protected Friend](../../language-reference/modifiers/protected-friend.md) + - [Protected Friend](../modifiers/protected-friend.md) - - [Private Protected](../../language-reference/modifiers/private-protected.md) + - [Private Protected](../modifiers/private-protected.md) - See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). + See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). - `proceduremodifiers` Optional. Can be one of the following: - - [Overloads](../../../visual-basic/language-reference/modifiers/overloads.md) + - [Overloads](../modifiers/overloads.md) - - [Overrides](../../../visual-basic/language-reference/modifiers/overrides.md) + - [Overrides](../modifiers/overrides.md) - - [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) + - [Overridable](../modifiers/overridable.md) - - [NotOverridable](../../../visual-basic/language-reference/modifiers/notoverridable.md) + - [NotOverridable](../modifiers/notoverridable.md) - - [MustOverride](../../../visual-basic/language-reference/modifiers/mustoverride.md) + - [MustOverride](../modifiers/mustoverride.md) - `MustOverride Overrides` @@ -88,23 +88,23 @@ End Function - `Shared` - Optional. See [Shared](../../../visual-basic/language-reference/modifiers/shared.md). + Optional. See [Shared](../modifiers/shared.md). - `Shadows` - Optional. See [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md). + Optional. See [Shadows](../modifiers/shadows.md). - `Async` - Optional. See [Async](../../../visual-basic/language-reference/modifiers/async.md). + Optional. See [Async](../modifiers/async.md). - `Iterator` - Optional. See [Iterator](../../../visual-basic/language-reference/modifiers/iterator.md). + Optional. See [Iterator](../modifiers/iterator.md). - `name` - Required. Name of the procedure. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). + Required. Name of the procedure. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). - `typeparamlist` @@ -181,7 +181,7 @@ A `Function` procedure can declare the data type of the value that the procedure If this procedure uses the `Implements` keyword, the containing class or structure must also have an `Implements` statement that immediately follows its `Class` or `Structure` statement. The `Implements` statement must include each interface that's specified in `implementslist`. However, the name by which an interface defines the `Function` (in `definedname`) doesn't need to match the name of this procedure (in `name`). > [!NOTE] -> You can use lambda expressions to define function expressions inline. For more information, see [Function Expression](../../../visual-basic/language-reference/operators/function-expression.md) and [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md). +> You can use lambda expressions to define function expressions inline. For more information, see [Function Expression](../operators/function-expression.md) and [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md). ## Returning from a Function @@ -215,18 +215,18 @@ Visual Basic sometimes rearranges arithmetic expressions to increase internal ef The *Async* feature allows you to invoke asynchronous functions without using explicit callbacks or manually splitting your code across multiple functions or lambda expressions. -If you mark a function with the [Async](../../../visual-basic/language-reference/modifiers/async.md) modifier, you can use the [Await](../../../visual-basic/language-reference/operators/await-operator.md) operator in the function. When control reaches an `Await` expression in the `Async` function, control returns to the caller, and progress in the function is suspended until the awaited task completes. When the task is complete, execution can resume in the function. +If you mark a function with the [Async](../modifiers/async.md) modifier, you can use the [Await](../operators/await-operator.md) operator in the function. When control reaches an `Await` expression in the `Async` function, control returns to the caller, and progress in the function is suspended until the awaited task completes. When the task is complete, execution can resume in the function. > [!NOTE] > An `Async` procedure returns to the caller when either it encounters the first awaited object that’s not yet complete, or it gets to the end of the `Async` procedure, whichever occurs first. An `Async` function can have a return type of or . An example of an `Async` function that has a return type of is provided below. -An `Async` function cannot declare any [ByRef](../../../visual-basic/language-reference/modifiers/byref.md) parameters. +An `Async` function cannot declare any [ByRef](../modifiers/byref.md) parameters. A [Sub Statement](sub-statement.md) can also be marked with the `Async` modifier. This is primarily used for event handlers, where a value cannot be returned. An `Async` `Sub` procedure can't be awaited, and the caller of an `Async` `Sub` procedure can't catch exceptions that are thrown by the `Sub` procedure. -For more information about `Async` functions, see [Asynchronous Programming with Async and Await](../../../visual-basic/programming-guide/concepts/async/index.md), [Control Flow in Async Programs](../../../visual-basic/programming-guide/concepts/async/control-flow-in-async-programs.md), and [Async Return Types](../../../visual-basic/programming-guide/concepts/async/async-return-types.md). +For more information about `Async` functions, see [Asynchronous Programming with Async and Await](../../programming-guide/concepts/async/index.md), [Control Flow in Async Programs](../../programming-guide/concepts/async/control-flow-in-async-programs.md), and [Async Return Types](../../programming-guide/concepts/async/async-return-types.md). ## Iterator Functions @@ -261,13 +261,13 @@ The `startButton_Click` procedure is an example of an `Async Sub` procedure. Bec ## See also - [Sub Statement](sub-statement.md) -- [Function Procedures](../../../visual-basic/programming-guide/language-features/procedures/function-procedures.md) +- [Function Procedures](../../programming-guide/language-features/procedures/function-procedures.md) - [Parameter List](parameter-list.md) - [Dim Statement](dim-statement.md) - [Call Statement](call-statement.md) - [Of](of-clause.md) -- [Parameter Arrays](../../../visual-basic/programming-guide/language-features/procedures/parameter-arrays.md) -- [How to: Use a Generic Class](../../../visual-basic/programming-guide/language-features/data-types/how-to-use-a-generic-class.md) -- [Troubleshooting Procedures](../../../visual-basic/programming-guide/language-features/procedures/troubleshooting-procedures.md) -- [Lambda Expressions](../../../visual-basic/programming-guide/language-features/procedures/lambda-expressions.md) -- [Function Expression](../../../visual-basic/language-reference/operators/function-expression.md) +- [Parameter Arrays](../../programming-guide/language-features/procedures/parameter-arrays.md) +- [How to: Use a Generic Class](../../programming-guide/language-features/data-types/how-to-use-a-generic-class.md) +- [Troubleshooting Procedures](../../programming-guide/language-features/procedures/troubleshooting-procedures.md) +- [Lambda Expressions](../../programming-guide/language-features/procedures/lambda-expressions.md) +- [Function Expression](../operators/function-expression.md) diff --git a/docs/visual-basic/language-reference/statements/get-statement.md b/docs/visual-basic/language-reference/statements/get-statement.md index bb914fd217316..4eec9a42196da 100644 --- a/docs/visual-basic/language-reference/statements/get-statement.md +++ b/docs/visual-basic/language-reference/statements/get-statement.md @@ -27,8 +27,8 @@ End Get |Term|Definition| |---|---| -|`attributelist`|Optional. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md).| -|`accessmodifier`|Optional on at most one of the `Get` and `Set` statements in this property. Can be one of the following:

- [Protected](../../../visual-basic/language-reference/modifiers/protected.md)
- [Friend](../../../visual-basic/language-reference/modifiers/friend.md)
- [Private](../../../visual-basic/language-reference/modifiers/private.md)
- `Protected Friend`

See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md).| +|`attributelist`|Optional. See [Attribute List](attribute-list.md).| +|`accessmodifier`|Optional on at most one of the `Get` and `Set` statements in this property. Can be one of the following:

- [Protected](../modifiers/protected.md)
- [Friend](../modifiers/friend.md)
- [Private](../modifiers/private.md)
- `Protected Friend`

See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md).| |`statements`|Optional. One or more statements that run when the `Get` property procedure is called.| |`End Get`|Required. Terminates the definition of the `Get` property procedure.| @@ -37,7 +37,7 @@ End Get Visual Basic automatically calls a property's `Get` procedure when an expression requests the property's value. - The body of the property declaration can contain only the property's `Get` and `Set` procedures between the [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) and the `End Property` statement. It cannot store anything other than those procedures. In particular, it cannot store the property's current value. You must store this value outside the property, because if you store it inside either of the property procedures, the other property procedure cannot access it. The usual approach is to store the value in a [Private](../../../visual-basic/language-reference/modifiers/private.md) variable declared at the same level as the property. You must define a `Get` procedure inside the property to which it applies. + The body of the property declaration can contain only the property's `Get` and `Set` procedures between the [Property Statement](property-statement.md) and the `End Property` statement. It cannot store anything other than those procedures. In particular, it cannot store the property's current value. You must store this value outside the property, because if you store it inside either of the property procedures, the other property procedure cannot access it. The usual approach is to store the value in a [Private](../modifiers/private.md) variable declared at the same level as the property. You must define a `Get` procedure inside the property to which it applies. The `Get` procedure defaults to the access level of its containing property unless you use `accessmodifier` in the `Get` statement. @@ -47,7 +47,7 @@ End Get If you are defining a `ReadOnly` property, the `Get` procedure represents the entire property. You cannot declare a different access level for `Get`, because that would set two access levels for the property. -- **Return Type.** The [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) can declare the data type of the value it returns. The `Get` procedure automatically returns that data type. You can specify any data type or the name of an enumeration, structure, class, or interface. +- **Return Type.** The [Property Statement](property-statement.md) can declare the data type of the value it returns. The `Get` procedure automatically returns that data type. You can specify any data type or the name of an enumeration, structure, class, or interface. If the `Property` statement does not specify `returntype`, the procedure returns `Object`. @@ -55,13 +55,13 @@ End Get - **Returning from a Procedure.** When the `Get` procedure returns to the calling code, execution continues within the statement that requested the property value. - `Get` property procedures can return a value using either the [Return Statement](../../../visual-basic/language-reference/statements/return-statement.md) or by assigning the return value to the property name. For more information, see "Return Value" in [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md). + `Get` property procedures can return a value using either the [Return Statement](return-statement.md) or by assigning the return value to the property name. For more information, see "Return Value" in [Function Statement](function-statement.md). The `Exit Property` and `Return` statements cause an immediate exit from a property procedure. Any number of `Exit Property` and `Return` statements can appear anywhere in the procedure, and you can mix `Exit Property` and `Return` statements. -- **Return Value.** To return a value from a `Get` procedure, you can either assign the value to the property name or include it in a [Return Statement](../../../visual-basic/language-reference/statements/return-statement.md). The `Return` statement simultaneously assigns the `Get` procedure return value and exits the procedure. +- **Return Value.** To return a value from a `Get` procedure, you can either assign the value to the property name or include it in a [Return Statement](return-statement.md). The `Return` statement simultaneously assigns the `Get` procedure return value and exits the procedure. - If you use `Exit Property` without assigning a value to the property name, the `Get` procedure returns the default value for the property's data type. For more information, see "Return Value" in [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md). + If you use `Exit Property` without assigning a value to the property name, the `Get` procedure returns the default value for the property's data type. For more information, see "Return Value" in [Function Statement](function-statement.md). The following example illustrates two ways the read-only property `quoteForTheDay` can return the value held in the private variable `quoteValue`. @@ -78,8 +78,8 @@ End Get ## See also -- [Set Statement](../../../visual-basic/language-reference/statements/set-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) -- [Walkthrough: Defining Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/walkthrough-defining-classes.md) +- [Set Statement](set-statement.md) +- [Property Statement](property-statement.md) +- [Exit Statement](exit-statement.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) +- [Walkthrough: Defining Classes](../../programming-guide/language-features/objects-and-classes/walkthrough-defining-classes.md) diff --git a/docs/visual-basic/language-reference/statements/goto-statement.md b/docs/visual-basic/language-reference/statements/goto-statement.md index 6826370abbffc..2127cbeb72676 100644 --- a/docs/visual-basic/language-reference/statements/goto-statement.md +++ b/docs/visual-basic/language-reference/statements/goto-statement.md @@ -28,10 +28,10 @@ GoTo line Required. Any line label. ## Remarks - The `GoTo` statement can branch only to lines in the procedure in which it appears. The line must have a line label that `GoTo` can refer to. For more information, see [How to: Label Statements](../../../visual-basic/programming-guide/program-structure/how-to-label-statements.md). + The `GoTo` statement can branch only to lines in the procedure in which it appears. The line must have a line label that `GoTo` can refer to. For more information, see [How to: Label Statements](../../programming-guide/program-structure/how-to-label-statements.md). > [!NOTE] -> `GoTo` statements can make code difficult to read and maintain. Whenever possible, use a control structure instead. For more information, see [Control Flow](../../../visual-basic/programming-guide/language-features/control-flow/index.md). +> `GoTo` statements can make code difficult to read and maintain. Whenever possible, use a control structure instead. For more information, see [Control Flow](../../programming-guide/language-features/control-flow/index.md). You cannot use a `GoTo` statement to branch from outside a `For`...`Next`, `For Each`...`Next`, `SyncLock`...`End SyncLock`, `Try`...`Catch`...`Finally`, `With`...`End With`, or `Using`...`End Using` construction to a label inside. @@ -57,11 +57,11 @@ GoTo line ## See also -- [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md) -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md) -- [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) -- [Select...Case Statement](../../../visual-basic/language-reference/statements/select-case-statement.md) -- [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) -- [While...End While Statement](../../../visual-basic/language-reference/statements/while-end-while-statement.md) -- [With...End With Statement](../../../visual-basic/language-reference/statements/with-end-with-statement.md) +- [Do...Loop Statement](do-loop-statement.md) +- [For...Next Statement](for-next-statement.md) +- [For Each...Next Statement](for-each-next-statement.md) +- [If...Then...Else Statement](if-then-else-statement.md) +- [Select...Case Statement](select-case-statement.md) +- [Try...Catch...Finally Statement](try-catch-finally-statement.md) +- [While...End While Statement](while-end-while-statement.md) +- [With...End With Statement](with-end-with-statement.md) diff --git a/docs/visual-basic/language-reference/statements/handles-clause.md b/docs/visual-basic/language-reference/statements/handles-clause.md index 945a77eaeb631..a3c21fa11cfe6 100644 --- a/docs/visual-basic/language-reference/statements/handles-clause.md +++ b/docs/visual-basic/language-reference/statements/handles-clause.md @@ -27,9 +27,9 @@ proceduredeclaration Handles eventlist ## Remarks Use the `Handles` keyword at the end of a procedure declaration to cause it to handle events raised by an object variable declared using the `WithEvents` keyword. The `Handles` keyword can also be used in a derived class to handle events from a base class. - The `Handles` keyword and the `AddHandler` statement both allow you to specify that particular procedures handle particular events, but there are differences. Use the `Handles` keyword when defining a procedure to specify that it handles a particular event. The `AddHandler` statement connects procedures to events at run time. For more information, see [AddHandler Statement](../../../visual-basic/language-reference/statements/addhandler-statement.md). + The `Handles` keyword and the `AddHandler` statement both allow you to specify that particular procedures handle particular events, but there are differences. Use the `Handles` keyword when defining a procedure to specify that it handles a particular event. The `AddHandler` statement connects procedures to events at run time. For more information, see [AddHandler Statement](addhandler-statement.md). - For custom events, the application invokes the event's `AddHandler` accessor when it adds the procedure as an event handler. For more information on custom events, see [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md). + For custom events, the application invokes the event's `AddHandler` accessor when it adds the procedure as an event handler. For more information on custom events, see [Event Statement](event-statement.md). ## Example [!code-vb[VbVbalrEvents#2](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb#2)] @@ -50,9 +50,9 @@ proceduredeclaration Handles eventlist ## See also -- [WithEvents](../../../visual-basic/language-reference/modifiers/withevents.md) -- [AddHandler Statement](../../../visual-basic/language-reference/statements/addhandler-statement.md) -- [RemoveHandler Statement](../../../visual-basic/language-reference/statements/removehandler-statement.md) -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [RaiseEvent Statement](../../../visual-basic/language-reference/statements/raiseevent-statement.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [WithEvents](../modifiers/withevents.md) +- [AddHandler Statement](addhandler-statement.md) +- [RemoveHandler Statement](removehandler-statement.md) +- [Event Statement](event-statement.md) +- [RaiseEvent Statement](raiseevent-statement.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/statements/if-then-else-statement.md b/docs/visual-basic/language-reference/statements/if-then-else-statement.md index 359e19231bd7d..a4f07f4e1094e 100644 --- a/docs/visual-basic/language-reference/statements/if-then-else-statement.md +++ b/docs/visual-basic/language-reference/statements/if-then-else-statement.md @@ -55,7 +55,7 @@ This article includes several examples that illustrate uses of the `If`...`Then` `condition` \ Required. Expression. Must evaluate to `True` or `False`, or to a data type that is implicitly convertible to `Boolean`. -If the expression is a [Nullable](../../../visual-basic/programming-guide/language-features/data-types/nullable-value-types.md) `Boolean` variable that evaluates to [Nothing](../../../visual-basic/language-reference/nothing.md), the condition is treated as if the expression is `False`, and the `ElseIf` blocks are evaluated if they exist, or the `Else` block is executed if it exists. +If the expression is a [Nullable](../../programming-guide/language-features/data-types/nullable-value-types.md) `Boolean` variable that evaluates to [Nothing](../nothing.md), the condition is treated as if the expression is `False`, and the `ElseIf` blocks are evaluated if they exist, or the `Else` block is executed if it exists. `Then` \ Required in the single-line syntax; optional in the multiline syntax. @@ -86,7 +86,7 @@ The `ElseIf` and `Else` clauses are both optional. You can have as many `ElseIf` In the multiline syntax, the `If` statement must be the only statement on the first line. The `ElseIf`, `Else`, and `End If` statements can be preceded only by a line label. The `If`...`Then`...`Else` block must end with an `End If` statement. > [!TIP] -> The [Select...Case Statement](../../../visual-basic/language-reference/statements/select-case-statement.md) might be more useful when you evaluate a single expression that has several possible values. +> The [Select...Case Statement](select-case-statement.md) might be more useful when you evaluate a single expression that has several possible values. ### Single-Line syntax @@ -123,9 +123,9 @@ The following example illustrates the use of the single-line syntax. - - -- [#If...Then...#Else Directives](../../../visual-basic/language-reference/directives/if-then-else-directives.md) -- [Select...Case Statement](../../../visual-basic/language-reference/statements/select-case-statement.md) -- [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md) -- [Decision Structures](../../../visual-basic/programming-guide/language-features/control-flow/decision-structures.md) -- [Logical and Bitwise Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) -- [If Operator](../../../visual-basic/language-reference/operators/if-operator.md) +- [#If...Then...#Else Directives](../directives/if-then-else-directives.md) +- [Select...Case Statement](select-case-statement.md) +- [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md) +- [Decision Structures](../../programming-guide/language-features/control-flow/decision-structures.md) +- [Logical and Bitwise Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/logical-and-bitwise-operators.md) +- [If Operator](../operators/if-operator.md) diff --git a/docs/visual-basic/language-reference/statements/implements-clause.md b/docs/visual-basic/language-reference/statements/implements-clause.md index 1d1c918076fce..de80fc7fd3fd2 100644 --- a/docs/visual-basic/language-reference/statements/implements-clause.md +++ b/docs/visual-basic/language-reference/statements/implements-clause.md @@ -22,26 +22,26 @@ ms.assetid: 5252cdf9-964d-4fc6-af0f-0449b7126b5a Indicates that a class or structure member is providing the implementation for a member defined in an interface. ## Remarks -The `Implements` keyword is not the same as the [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md). You use the `Implements` statement to specify that a class or structure implements one or more interfaces, and then for each member you use the `Implements` keyword to specify which interface and which member it implements. +The `Implements` keyword is not the same as the [Implements Statement](implements-statement.md). You use the `Implements` statement to specify that a class or structure implements one or more interfaces, and then for each member you use the `Implements` keyword to specify which interface and which member it implements. -If a class or structure implements an interface, it must include the `Implements` statement immediately after the [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) or [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md), and it must implement all the members defined by the interface. +If a class or structure implements an interface, it must include the `Implements` statement immediately after the [Class Statement](class-statement.md) or [Structure Statement](structure-statement.md), and it must implement all the members defined by the interface. ## Reimplementation In a derived class, you can reimplement an interface member that the base class has already implemented. This is different from overriding the base class member in the following respects: -- The base class member does not need to be [Overridable](../../../visual-basic/language-reference/modifiers/overridable.md) to be reimplemented. +- The base class member does not need to be [Overridable](../modifiers/overridable.md) to be reimplemented. - You can reimplement the member with a different name. The `Implements` keyword can be used in the following contexts: -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) +- [Event Statement](event-statement.md) +- [Function Statement](function-statement.md) +- [Property Statement](property-statement.md) +- [Sub Statement](sub-statement.md) ## See also -- [Implements Statement](../../../visual-basic/language-reference/statements/implements-statement.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) +- [Implements Statement](implements-statement.md) +- [Interface Statement](interface-statement.md) +- [Class Statement](class-statement.md) +- [Structure Statement](structure-statement.md) diff --git a/docs/visual-basic/language-reference/statements/implements-statement.md b/docs/visual-basic/language-reference/statements/implements-statement.md index 02a2dce1e2c9e..1088ec876ac81 100644 --- a/docs/visual-basic/language-reference/statements/implements-statement.md +++ b/docs/visual-basic/language-reference/statements/implements-statement.md @@ -29,13 +29,13 @@ Implements interfacename.interfacemember [, ...] Required. The member of an interface that is being implemented. ## Remarks - An interface is a collection of prototypes representing the members (properties, procedures, and events) the interface encapsulates. Interfaces contain only the declarations for members; classes and structures implement these members. For more information, see [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md). + An interface is a collection of prototypes representing the members (properties, procedures, and events) the interface encapsulates. Interfaces contain only the declarations for members; classes and structures implement these members. For more information, see [Interfaces](../../programming-guide/language-features/interfaces/index.md). The `Implements` statement must immediately follow the `Class` or `Structure` statement. - When you implement an interface, you must implement all the members declared in the interface. Omitting any member is considered to be a syntax error. To implement an individual member, you specify the [Implements](../../../visual-basic/language-reference/statements/implements-clause.md) keyword (which is separate from the `Implements` statement) when you declare the member in the class or structure. For more information, see [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md). + When you implement an interface, you must implement all the members declared in the interface. Omitting any member is considered to be a syntax error. To implement an individual member, you specify the [Implements](implements-clause.md) keyword (which is separate from the `Implements` statement) when you declare the member in the class or structure. For more information, see [Interfaces](../../programming-guide/language-features/interfaces/index.md). - Classes can use [Private](../../../visual-basic/language-reference/modifiers/private.md) implementations of properties and procedures, but these members are accessible only by casting an instance of the implementing class into a variable declared to be of the type of the interface. + Classes can use [Private](../modifiers/private.md) implementations of properties and procedures, but these members are accessible only by casting an instance of the implementing class into a variable declared to be of the type of the interface. ## Example The following example shows how to use the `Implements` statement to implement members of an interface. It defines an interface named `ICustomerInfo` with an event, a property, and a procedure. The class `customerInfo` implements all the members defined in the interface. @@ -51,6 +51,6 @@ Implements interfacename.interfacemember [, ...] ## See also -- [Implements](../../../visual-basic/language-reference/statements/implements-clause.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) +- [Implements](implements-clause.md) +- [Interface Statement](interface-statement.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) diff --git a/docs/visual-basic/language-reference/statements/imports-statement-xml-namespace.md b/docs/visual-basic/language-reference/statements/imports-statement-xml-namespace.md index 10b443eb5b462..73b48615b5bb4 100644 --- a/docs/visual-basic/language-reference/statements/imports-statement-xml-namespace.md +++ b/docs/visual-basic/language-reference/statements/imports-statement-xml-namespace.md @@ -23,16 +23,16 @@ Imports ## Parts `xmlNamespacePrefix` -Optional. The string by which XML elements and attributes can refer to `xmlNamespaceName`. If no `xmlNamespacePrefix` is supplied, the imported XML namespace is the default XML namespace. Must be a valid XML identifier. For more information, see [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md). +Optional. The string by which XML elements and attributes can refer to `xmlNamespaceName`. If no `xmlNamespacePrefix` is supplied, the imported XML namespace is the default XML namespace. Must be a valid XML identifier. For more information, see [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md). `xmlNamespaceName` Required. The string identifying the XML namespace being imported. ## Remarks -You can use the `Imports` statement to define global XML namespaces that you can use with XML literals and XML axis properties, or as parameters passed to the `GetXmlNamespace` operator. (For information about using the `Imports` statement to import an alias that can be used where type names are used in your code, see [Imports Statement (.NET Namespace and Type)](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md).) The syntax for declaring an XML namespace by using the `Imports` statement is identical to the syntax used in XML. Therefore, you can copy a namespace declaration from an XML file and use it in an `Imports` statement. +You can use the `Imports` statement to define global XML namespaces that you can use with XML literals and XML axis properties, or as parameters passed to the `GetXmlNamespace` operator. (For information about using the `Imports` statement to import an alias that can be used where type names are used in your code, see [Imports Statement (.NET Namespace and Type)](imports-statement-net-namespace-and-type.md).) The syntax for declaring an XML namespace by using the `Imports` statement is identical to the syntax used in XML. Therefore, you can copy a namespace declaration from an XML file and use it in an `Imports` statement. -XML namespace prefixes are useful when you want to repeatedly create XML elements that are from the same namespace. The XML namespace prefix declared with the `Imports` statement is global in the sense that it is available to all code in the file. You can use it when you create XML element literals and when you access XML axis properties. For more information, see [XML Element Literal](../../../visual-basic/language-reference/xml-literals/xml-element-literal.md) and [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md). +XML namespace prefixes are useful when you want to repeatedly create XML elements that are from the same namespace. The XML namespace prefix declared with the `Imports` statement is global in the sense that it is available to all code in the file. You can use it when you create XML element literals and when you access XML axis properties. For more information, see [XML Element Literal](../xml-literals/xml-element-literal.md) and [XML Axis Properties](../xml-axis/index.md). If you define a global XML namespace without a namespace prefix (for example, `Imports "`), that namespace is considered the default XML namespace. The default XML namespace is used for any XML element literals or XML attribute axis properties that do not explicitly specify a namespace. The default namespace is also used if the specified namespace is the empty namespace (that is, `xmlns=""`). The default XML namespace does not apply to XML attributes in XML literals or to XML attribute axis properties that do not have a namespace. @@ -90,7 +90,7 @@ This code displays the following text: ## See also -- [XML Element Literal](../../../visual-basic/language-reference/xml-literals/xml-element-literal.md) -- [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md) -- [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) -- [GetXmlNamespace Operator](../../../visual-basic/language-reference/operators/getxmlnamespace-operator.md) +- [XML Element Literal](../xml-literals/xml-element-literal.md) +- [XML Axis Properties](../xml-axis/index.md) +- [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) +- [GetXmlNamespace Operator](../operators/getxmlnamespace-operator.md) diff --git a/docs/visual-basic/language-reference/statements/in-clause.md b/docs/visual-basic/language-reference/statements/in-clause.md index 5c83c211eb21d..2c192cc80fe08 100644 --- a/docs/visual-basic/language-reference/statements/in-clause.md +++ b/docs/visual-basic/language-reference/statements/in-clause.md @@ -13,14 +13,14 @@ Specifies the group that the loop variable is to traverse in a `For Each` loop, ## Remarks The `In` keyword can be used in the following contexts: - [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md) + [For Each...Next Statement](for-each-next-statement.md) - [From Clause](../../../visual-basic/language-reference/queries/from-clause.md) + [From Clause](../queries/from-clause.md) - [Join Clause](../../../visual-basic/language-reference/queries/join-clause.md) + [Join Clause](../queries/join-clause.md) - [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) + [Group Join Clause](../queries/group-join-clause.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/statements/index.md b/docs/visual-basic/language-reference/statements/index.md index b79b32a2c1de1..47c0aa4a767aa 100644 --- a/docs/visual-basic/language-reference/statements/index.md +++ b/docs/visual-basic/language-reference/statements/index.md @@ -9,22 +9,22 @@ ms.assetid: 1cbd7703-8d3b-48fd-831e-14c9cc85675a The topics in this section contain tables of the Visual Basic declaration and executable statements, and of important lists that apply to many statements. ## In This Section - [A-E Statements](../../../visual-basic/language-reference/statements/a-e-statements.md) + [A-E Statements](a-e-statements.md) - [F-P Statements](../../../visual-basic/language-reference/statements/f-p-statements.md) + [F-P Statements](f-p-statements.md) - [Q-Z Statements](../../../visual-basic/language-reference/statements/q-z-statements.md) + [Q-Z Statements](q-z-statements.md) - [Clauses](../../../visual-basic/language-reference/statements/clauses.md) + [Clauses](clauses.md) - [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md) + [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md) - [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md) + [Attribute List](attribute-list.md) - [Parameter List](../../../visual-basic/language-reference/statements/parameter-list.md) + [Parameter List](parameter-list.md) - [Type List](../../../visual-basic/language-reference/statements/type-list.md) + [Type List](type-list.md) ## Related Sections - [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) + [Visual Basic Language Reference](../index.md) \ No newline at end of file diff --git a/docs/visual-basic/language-reference/statements/inherits-statement.md b/docs/visual-basic/language-reference/statements/inherits-statement.md index c16844baa7a46..411e8e886b41b 100644 --- a/docs/visual-basic/language-reference/statements/inherits-statement.md +++ b/docs/visual-basic/language-reference/statements/inherits-statement.md @@ -59,8 +59,8 @@ Inherits basetypenames ## See also -- [MustInherit](../../../visual-basic/language-reference/modifiers/mustinherit.md) -- [NotInheritable](../../../visual-basic/language-reference/modifiers/notinheritable.md) -- [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) -- [Inheritance Basics](../../../visual-basic/programming-guide/language-features/objects-and-classes/inheritance-basics.md) -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) +- [MustInherit](../modifiers/mustinherit.md) +- [NotInheritable](../modifiers/notinheritable.md) +- [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) +- [Inheritance Basics](../../programming-guide/language-features/objects-and-classes/inheritance-basics.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) diff --git a/docs/visual-basic/language-reference/statements/interface-statement.md b/docs/visual-basic/language-reference/statements/interface-statement.md index 991eae16e8682..d074043c33bdd 100644 --- a/docs/visual-basic/language-reference/statements/interface-statement.md +++ b/docs/visual-basic/language-reference/statements/interface-statement.md @@ -31,13 +31,13 @@ End Interface |Term|Definition| |---|---| -|`attributelist`|Optional. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md).| -|`accessmodifier`|Optional. Can be one of the following:

- [Public](../../../visual-basic/language-reference/modifiers/public.md)
- [Protected](../../../visual-basic/language-reference/modifiers/protected.md)
- [Friend](../../../visual-basic/language-reference/modifiers/friend.md)
- [Private](../../../visual-basic/language-reference/modifiers/private.md)
- [Protected Friend](../../language-reference/modifiers/protected-friend.md)
- [Private Protected](../../language-reference/modifiers/private-protected.md)

See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md).| -|`Shadows`|Optional. See [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md).| -|`name`|Required. Name of this interface. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md).| +|`attributelist`|Optional. See [Attribute List](attribute-list.md).| +|`accessmodifier`|Optional. Can be one of the following:

- [Public](../modifiers/public.md)
- [Protected](../modifiers/protected.md)
- [Friend](../modifiers/friend.md)
- [Private](../modifiers/private.md)
- [Protected Friend](../modifiers/protected-friend.md)
- [Private Protected](../modifiers/private-protected.md)

See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md).| +|`Shadows`|Optional. See [Shadows](../modifiers/shadows.md).| +|`name`|Required. Name of this interface. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md).| |`Of`|Optional. Specifies that this is a generic interface.| -|`typelist`|Required if you use the [Of](../../../visual-basic/language-reference/statements/of-clause.md) keyword. List of type parameters for this interface. Optionally, each type parameter can be declared variant by using `In` and `Out` generic modifiers. See [Type List](../../../visual-basic/language-reference/statements/type-list.md).| -|`Inherits`|Optional. Indicates that this interface inherits the attributes and members of another interface or interfaces. See [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md).| +|`typelist`|Required if you use the [Of](of-clause.md) keyword. List of type parameters for this interface. Optionally, each type parameter can be declared variant by using `In` and `Out` generic modifiers. See [Type List](type-list.md).| +|`Inherits`|Optional. Indicates that this interface inherits the attributes and members of another interface or interfaces. See [Inherits Statement](inherits-statement.md).| |`interfacenames`|Required if you use the `Inherits` statement. The names of the interfaces from which this interface derives.| |`modifiers`|Optional. Appropriate modifiers for the interface member being defined.| |`Property`|Optional. Defines a property that is a member of the interface.| @@ -53,11 +53,11 @@ End Interface ## Remarks An *interface* defines a set of members, such as properties and procedures, that classes and structures can implement. The interface defines only the signatures of the members and not their internal workings. - A class or structure implements the interface by supplying code for every member defined by the interface. Finally, when the application creates an instance from that class or structure, an object exists and runs in memory. For more information, see [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md) and [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md). + A class or structure implements the interface by supplying code for every member defined by the interface. Finally, when the application creates an instance from that class or structure, an object exists and runs in memory. For more information, see [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md) and [Interfaces](../../programming-guide/language-features/interfaces/index.md). - You can use `Interface` only at namespace or module level. This means the *declaration context* for an interface must be a source file, namespace, class, structure, module, or interface, and cannot be a procedure or block. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). + You can use `Interface` only at namespace or module level. This means the *declaration context* for an interface must be a source file, namespace, class, structure, module, or interface, and cannot be a procedure or block. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). - Interfaces default to [Friend](../../../visual-basic/language-reference/modifiers/friend.md) access. You can adjust their access levels with the access modifiers. For more information, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). + Interfaces default to [Friend](../modifiers/friend.md) access. You can adjust their access levels with the access modifiers. For more information, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). ## Rules @@ -67,25 +67,25 @@ End Interface In contrast, when you define an enumeration or structure, or a nested class or interface, it is necessary to include their data members. -- **Member Modifiers.** You cannot use any access modifiers when defining module members, nor can you specify [Shared](../../../visual-basic/language-reference/modifiers/shared.md) or any procedure modifier except [Overloads](../../../visual-basic/language-reference/modifiers/overloads.md). You can declare any member with [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md), and you can use [Default](../../../visual-basic/language-reference/modifiers/default.md) when defining a property, as well as [ReadOnly](../../../visual-basic/language-reference/modifiers/readonly.md) or [WriteOnly](../../../visual-basic/language-reference/modifiers/writeonly.md). +- **Member Modifiers.** You cannot use any access modifiers when defining module members, nor can you specify [Shared](../modifiers/shared.md) or any procedure modifier except [Overloads](../modifiers/overloads.md). You can declare any member with [Shadows](../modifiers/shadows.md), and you can use [Default](../modifiers/default.md) when defining a property, as well as [ReadOnly](../modifiers/readonly.md) or [WriteOnly](../modifiers/writeonly.md). -- **Inheritance.** If the interface uses the [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md), you can specify one or more base interfaces. You can inherit from two interfaces even if they each define a member with the same name. If you do so, the implementing code must use name qualification to specify which member it is implementing. +- **Inheritance.** If the interface uses the [Inherits Statement](inherits-statement.md), you can specify one or more base interfaces. You can inherit from two interfaces even if they each define a member with the same name. If you do so, the implementing code must use name qualification to specify which member it is implementing. An interface cannot inherit from another interface with a more restrictive access level. For example, a `Public` interface cannot inherit from a `Friend` interface. An interface cannot inherit from an interface nested within it. -- **Implementation.** When a class uses the [Implements](../../../visual-basic/language-reference/statements/implements-clause.md) statement to implement this interface, it must implement every member defined within the interface. Furthermore, each signature in the implementing code must exactly match the corresponding signature defined in this interface. However, the name of the member in the implementing code does not have to match the member name as defined in the interface. +- **Implementation.** When a class uses the [Implements](implements-clause.md) statement to implement this interface, it must implement every member defined within the interface. Furthermore, each signature in the implementing code must exactly match the corresponding signature defined in this interface. However, the name of the member in the implementing code does not have to match the member name as defined in the interface. When a class is implementing a procedure, it cannot designate the procedure as `Shared`. -- **Default Property.** An interface can specify at most one property as its *default property*, which can be referenced without using the property name. You specify such a property by declaring it with the [Default](../../../visual-basic/language-reference/modifiers/default.md) modifier. +- **Default Property.** An interface can specify at most one property as its *default property*, which can be referenced without using the property name. You specify such a property by declaring it with the [Default](../modifiers/default.md) modifier. Notice that this means that an interface can define a default property only if it inherits none. ## Behavior -- **Access Level.** All interface members implicitly have [Public](../../../visual-basic/language-reference/modifiers/public.md) access. You cannot use any access modifier when defining a member. However, a class implementing the interface can declare an access level for each implemented member. +- **Access Level.** All interface members implicitly have [Public](../modifiers/public.md) access. You cannot use any access modifier when defining a member. However, a class implementing the interface can declare an access level for each implemented member. If you assign a class instance to a variable, the access level of its members can depend on whether the data type of the variable is the underlying interface or the implementing class. The following example illustrates this. @@ -97,7 +97,7 @@ End Interface The scope of every interface member is the entire interface. -- **Lifetime.** An interface does not itself have a lifetime, nor do its members. When a class implements an interface and an object is created as an instance of that class, the object has a lifetime within the application in which it is running. For more information, see "Lifetime" in [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md). +- **Lifetime.** An interface does not itself have a lifetime, nor do its members. When a class implements an interface and an object is created as an instance of that class, the object has a lifetime within the application in which it is running. For more information, see "Lifetime" in [Class Statement](class-statement.md). ## Example The following example uses the `Interface` statement to define an interface named `thisInterface`, which must be implemented with a `Property` statement and a `Function` statement. @@ -108,14 +108,14 @@ End Interface ## See also -- [Interfaces](../../../visual-basic/programming-guide/language-features/interfaces/index.md) -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) -- [Module Statement](../../../visual-basic/language-reference/statements/module-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) +- [Interfaces](../../programming-guide/language-features/interfaces/index.md) +- [Class Statement](class-statement.md) +- [Module Statement](module-statement.md) +- [Structure Statement](structure-statement.md) +- [Property Statement](property-statement.md) +- [Function Statement](function-statement.md) +- [Sub Statement](sub-statement.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) - [Variance in Generic Interfaces](../../programming-guide/concepts/covariance-contravariance/variance-in-generic-interfaces.md) -- [In](../../../visual-basic/language-reference/modifiers/in-generic-modifier.md) -- [Out](../../../visual-basic/language-reference/modifiers/out-generic-modifier.md) +- [In](../modifiers/in-generic-modifier.md) +- [Out](../modifiers/out-generic-modifier.md) diff --git a/docs/visual-basic/language-reference/statements/into-clause.md b/docs/visual-basic/language-reference/statements/into-clause.md index 91601f5e7ced7..81fdc202b7eae 100644 --- a/docs/visual-basic/language-reference/statements/into-clause.md +++ b/docs/visual-basic/language-reference/statements/into-clause.md @@ -11,12 +11,12 @@ Identifies aggregate functions or groupings to apply to a collection. ## Remarks The `Each` keyword is used in the following contexts: - [Aggregate Clause](../../../visual-basic/language-reference/queries/aggregate-clause.md) + [Aggregate Clause](../queries/aggregate-clause.md) - [Group By Clause](../../../visual-basic/language-reference/queries/group-by-clause.md) + [Group By Clause](../queries/group-by-clause.md) - [Group Join Clause](../../../visual-basic/language-reference/queries/group-join-clause.md) + [Group Join Clause](../queries/group-join-clause.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/statements/mid-statement.md b/docs/visual-basic/language-reference/statements/mid-statement.md index 3276188a7eb6a..3561b5ea4c368 100644 --- a/docs/visual-basic/language-reference/statements/mid-statement.md +++ b/docs/visual-basic/language-reference/statements/mid-statement.md @@ -57,7 +57,7 @@ Mid( _ [!code-vb[VbVbalrStrings#5](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStrings/VB/Class1.vb#5)] ## Requirements - **Namespace:** [Microsoft.VisualBasic](../../../visual-basic/language-reference/runtime-library-members.md) + **Namespace:** [Microsoft.VisualBasic](../runtime-library-members.md) **Module:** `Strings` @@ -66,5 +66,5 @@ Mid( _ ## See also - -- [Strings](../../../visual-basic/programming-guide/language-features/strings/index.md) -- [Introduction to Strings in Visual Basic](../../../visual-basic/programming-guide/language-features/strings/introduction-to-strings.md) +- [Strings](../../programming-guide/language-features/strings/index.md) +- [Introduction to Strings in Visual Basic](../../programming-guide/language-features/strings/introduction-to-strings.md) diff --git a/docs/visual-basic/language-reference/statements/module-statement.md b/docs/visual-basic/language-reference/statements/module-statement.md index f798bfbdb381e..7a3917fb5c10f 100644 --- a/docs/visual-basic/language-reference/statements/module-statement.md +++ b/docs/visual-basic/language-reference/statements/module-statement.md @@ -29,19 +29,19 @@ End Module ## Parts `attributelist` -Optional. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md). +Optional. See [Attribute List](attribute-list.md). `accessmodifier` Optional. Can be one of the following: -- [Public](../../../visual-basic/language-reference/modifiers/public.md) +- [Public](../modifiers/public.md) -- [Friend](../../../visual-basic/language-reference/modifiers/friend.md) +- [Friend](../modifiers/friend.md) -See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). `name` -Required. Name of this module. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). +Required. Name of this module. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). `statements` Optional. Statements which define the variables, properties, events, procedures, and nested types of this module. @@ -53,11 +53,11 @@ Terminates the `Module` definition. A `Module` statement defines a reference type available throughout its namespace. A *module* (sometimes called a *standard module*) is similar to a class but with some important distinctions. Every module has exactly one instance and does not need to be created or assigned to a variable. Modules do not support inheritance or implement interfaces. Notice that a module is not a *type* in the sense that a class or structure is — you cannot declare a programming element to have the data type of a module. -You can use `Module` only at namespace level. This means the *declaration context* for a module must be a source file or namespace, and cannot be a class, structure, module, interface, procedure, or block. You cannot nest a module within another module, or within any type. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). +You can use `Module` only at namespace level. This means the *declaration context* for a module must be a source file or namespace, and cannot be a class, structure, module, interface, procedure, or block. You cannot nest a module within another module, or within any type. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). A module has the same lifetime as your program. Because its members are all `Shared`, they also have lifetimes equal to that of the program. -Modules default to [Friend](../../../visual-basic/language-reference/modifiers/friend.md) access. You can adjust their access levels with the access modifiers. For more information, see [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). +Modules default to [Friend](../modifiers/friend.md) access. You can adjust their access levels with the access modifiers. For more information, see [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). All members of a module are implicitly `Shared`. @@ -69,27 +69,27 @@ These elements have many similarities, but there are some important differences - **Shared Members.** You can control whether a member of a class is a shared or instance member. -- **Object Orientation.** Classes are object-oriented, but modules are not. So only classes can be instantiated as objects. For more information, see [Objects and Classes](../../../visual-basic/programming-guide/language-features/objects-and-classes/index.md). +- **Object Orientation.** Classes are object-oriented, but modules are not. So only classes can be instantiated as objects. For more information, see [Objects and Classes](../../programming-guide/language-features/objects-and-classes/index.md). ## Rules -- **Modifiers.** All module members are implicitly [Shared](../../../visual-basic/language-reference/modifiers/shared.md). You cannot use the `Shared` keyword when declaring a member, and you cannot alter the shared status of any member. +- **Modifiers.** All module members are implicitly [Shared](../modifiers/shared.md). You cannot use the `Shared` keyword when declaring a member, and you cannot alter the shared status of any member. - **Inheritance.** A module cannot inherit from any type other than , from which all modules inherit. In particular, one module cannot inherit from another. - You cannot use the [Inherits Statement](../../../visual-basic/language-reference/statements/inherits-statement.md) in a module definition, even to specify . + You cannot use the [Inherits Statement](inherits-statement.md) in a module definition, even to specify . -- **Default Property.** You cannot define any default properties in a module. For more information, see [Default](../../../visual-basic/language-reference/modifiers/default.md). +- **Default Property.** You cannot define any default properties in a module. For more information, see [Default](../modifiers/default.md). ## Behavior -- **Access Level.** Within a module, you can declare each member with its own access level. Module members default to [Public](../../../visual-basic/language-reference/modifiers/public.md) access, except variables and constants, which default to [Private](../../../visual-basic/language-reference/modifiers/private.md) access. When a module has more restricted access than one of its members, the specified module access level takes precedence. +- **Access Level.** Within a module, you can declare each member with its own access level. Module members default to [Public](../modifiers/public.md) access, except variables and constants, which default to [Private](../modifiers/private.md) access. When a module has more restricted access than one of its members, the specified module access level takes precedence. - **Scope.** A module is in scope throughout its namespace. - The scope of every module member is the entire module. Notice that all members undergo *type promotion*, which causes their scope to be promoted to the namespace containing the module. For more information, see [Type Promotion](../../../visual-basic/programming-guide/language-features/declared-elements/type-promotion.md). + The scope of every module member is the entire module. Notice that all members undergo *type promotion*, which causes their scope to be promoted to the namespace containing the module. For more information, see [Type Promotion](../../programming-guide/language-features/declared-elements/type-promotion.md). -- **Qualification.** You can have multiple modules in a project, and you can declare members with the same name in two or more modules. However, you must qualify any reference to such a member with the appropriate module name if the reference is from outside that module. For more information, see [References to Declared Elements](../../../visual-basic/programming-guide/language-features/declared-elements/references-to-declared-elements.md). +- **Qualification.** You can have multiple modules in a project, and you can declare members with the same name in two or more modules. However, you must qualify any reference to such a member with the appropriate module name if the reference is from outside that module. For more information, see [References to Declared Elements](../../programming-guide/language-features/declared-elements/references-to-declared-elements.md). ## Example @@ -97,9 +97,9 @@ These elements have many similarities, but there are some important differences ## See also -- [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) -- [Namespace Statement](../../../visual-basic/language-reference/statements/namespace-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) -- [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Type Promotion](../../../visual-basic/programming-guide/language-features/declared-elements/type-promotion.md) +- [Class Statement](class-statement.md) +- [Namespace Statement](namespace-statement.md) +- [Structure Statement](structure-statement.md) +- [Interface Statement](interface-statement.md) +- [Property Statement](property-statement.md) +- [Type Promotion](../../programming-guide/language-features/declared-elements/type-promotion.md) diff --git a/docs/visual-basic/language-reference/statements/namespace-statement.md b/docs/visual-basic/language-reference/statements/namespace-statement.md index 9591dd2c46002..d09cec38f3830 100644 --- a/docs/visual-basic/language-reference/statements/namespace-statement.md +++ b/docs/visual-basic/language-reference/statements/namespace-statement.md @@ -26,10 +26,10 @@ End Namespace ## Parts Global - Optional. Allows you to define a namespace out of the root namespace of your project. See [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md). + Optional. Allows you to define a namespace out of the root namespace of your project. See [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md). `name` - Required. A unique name that identifies the namespace. Must be a valid Visual Basic identifier. For more information, see [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). + Required. A unique name that identifies the namespace. Must be a valid Visual Basic identifier. For more information, see [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). `componenttypes` Optional. Elements that make up the namespace. These include, but are not limited to, enumerations, structures, interfaces, classes, modules, delegates, and other namespaces. @@ -44,23 +44,23 @@ End Namespace If a namespace is already defined, even outside your project, you can add programming elements to it. To do this, you use a `Namespace` statement to direct Visual Basic to compile elements into that namespace. - You can use a `Namespace` statement only at the file or namespace level. This means the *declaration context* for a namespace must be a source file or another namespace, and cannot be a class, structure, module, interface, or procedure. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). + You can use a `Namespace` statement only at the file or namespace level. This means the *declaration context* for a namespace must be a source file or another namespace, and cannot be a class, structure, module, interface, or procedure. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). You can declare one namespace within another. There is no strict limit to the levels of nesting you can declare, but remember that when other code accesses the elements declared in the innermost namespace, it must use a qualification string that contains all the namespace names in the nesting hierarchy. ## Access Level Namespaces are treated as if they have a `Public` access level. A namespace can be accessed from code anywhere in the same project, from other projects that reference the project, and from any assembly built from the project. - Programming elements declared at namespace level, meaning in a namespace but not inside any other element, can have `Public` or `Friend` access. If unspecified, the access level of such an element uses `Friend` by default. Elements you can declare at namespace level include classes, structures, modules, interfaces, enumerations, and delegates. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). + Programming elements declared at namespace level, meaning in a namespace but not inside any other element, can have `Public` or `Friend` access. If unspecified, the access level of such an element uses `Friend` by default. Elements you can declare at namespace level include classes, structures, modules, interfaces, enumerations, and delegates. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). ## Root Namespace All namespace names in your project are based on a *root namespace*. Visual Studio assigns your project name as the default root namespace for all code in your project. For example, if your project is named `Payroll`, its programming elements belong to namespace `Payroll`. If you declare `Namespace funding`, the full name of that namespace is `Payroll.funding`. If you want to specify an existing namespace in a `Namespace` statement, such as in the generic list class example, you can set your root namespace to a null value. To do this, click **Project Properties** from the **Project** menu and then clear the **Root namespace** entry so that the box is empty. If you did not do this in the generic list class example, the Visual Basic compiler would take `System.Collections.Generic` as a new namespace within project `Payroll`, with the full name of `Payroll.System.Collections.Generic`. - Alternatively, you can use the `Global` keyword to refer to elements of namespaces defined outside your project. Doing so lets you retain your project name as the root namespace. This reduces the chance of unintentionally merging your programming elements together with those of existing namespaces. For more information, see the "Global Keyword in Fully Qualified Names" section in [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md). + Alternatively, you can use the `Global` keyword to refer to elements of namespaces defined outside your project. Doing so lets you retain your project name as the root namespace. This reduces the chance of unintentionally merging your programming elements together with those of existing namespaces. For more information, see the "Global Keyword in Fully Qualified Names" section in [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md). - The `Global` keyword can also be used in a Namespace statement. This lets you define a namespace out of the root namespace of your project. For more information, see the "Global Keyword in Namespace Statements" section in [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md). + The `Global` keyword can also be used in a Namespace statement. This lets you define a namespace out of the root namespace of your project. For more information, see the "Global Keyword in Namespace Statements" section in [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md). **Troubleshooting.** The root namespace can lead to unexpected concatenations of namespace names. If you make reference to namespaces defined outside your project, the Visual Basic compiler can construe them as nested namespaces in the root namespace. In such a case, the compiler does not recognize any types that have been already defined in the external namespaces. To avoid this, either set your root namespace to a null value as described in "Root Namespace," or use the `Global` keyword to access elements of external namespaces. @@ -98,6 +98,6 @@ End Namespace ## See also -- [Imports Statement (.NET Namespace and Type)](../../../visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md) -- [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md) -- [Namespaces in Visual Basic](../../../visual-basic/programming-guide/program-structure/namespaces.md) +- [Imports Statement (.NET Namespace and Type)](imports-statement-net-namespace-and-type.md) +- [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md) +- [Namespaces in Visual Basic](../../programming-guide/program-structure/namespaces.md) diff --git a/docs/visual-basic/language-reference/statements/of-clause.md b/docs/visual-basic/language-reference/statements/of-clause.md index 13a7fab5dd584..6ce8bb1935488 100644 --- a/docs/visual-basic/language-reference/statements/of-clause.md +++ b/docs/visual-basic/language-reference/statements/of-clause.md @@ -19,10 +19,10 @@ helpviewer_keywords: ms.assetid: 0db8f65c-65af-4089-ab7f-6fcfecb60444 --- # Of Clause (Visual Basic) -Introduces an `Of` clause, which identifies a *type parameter* on a *generic* class, structure, interface, delegate, or procedure. For information on generic types, see [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md). +Introduces an `Of` clause, which identifies a *type parameter* on a *generic* class, structure, interface, delegate, or procedure. For information on generic types, see [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md). ## Using the Of Keyword - The following code example uses the `Of` keyword to define the outline of a class that takes two type parameters. It *constrains* the `keyType` parameter by the interface, which means the consuming code must supply a type argument that implements . This is necessary so that the `add` procedure can call the method. For more information on constraints, see [Type List](../../../visual-basic/language-reference/statements/type-list.md). + The following code example uses the `Of` keyword to define the outline of a class that takes two type parameters. It *constrains* the `keyType` parameter by the interface, which means the consuming code must supply a type argument that implements . This is necessary so that the `add` procedure can call the method. For more information on constraints, see [Type List](type-list.md). ```vb Public Class Dictionary(Of entryType, keyType As IComparable) @@ -46,22 +46,22 @@ Dim d As New dictionary(Of String, Integer) The `Of` keyword can be used in these contexts: - [Class Statement](../../../visual-basic/language-reference/statements/class-statement.md) + [Class Statement](class-statement.md) - [Delegate Statement](../../../visual-basic/language-reference/statements/delegate-statement.md) + [Delegate Statement](delegate-statement.md) - [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) + [Function Statement](function-statement.md) - [Interface Statement](../../../visual-basic/language-reference/statements/interface-statement.md) + [Interface Statement](interface-statement.md) - [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) + [Structure Statement](structure-statement.md) - [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) + [Sub Statement](sub-statement.md) ## See also - -- [Type List](../../../visual-basic/language-reference/statements/type-list.md) -- [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md) -- [In](../../../visual-basic/language-reference/modifiers/in-generic-modifier.md) -- [Out](../../../visual-basic/language-reference/modifiers/out-generic-modifier.md) +- [Type List](type-list.md) +- [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md) +- [In](../modifiers/in-generic-modifier.md) +- [Out](../modifiers/out-generic-modifier.md) diff --git a/docs/visual-basic/language-reference/statements/on-error-statement.md b/docs/visual-basic/language-reference/statements/on-error-statement.md index c820cef8b559c..94aa53fb84187 100644 --- a/docs/visual-basic/language-reference/statements/on-error-statement.md +++ b/docs/visual-basic/language-reference/statements/on-error-statement.md @@ -29,7 +29,7 @@ Enables an error-handling routine and specifies the location of the routine with Without error handling or exception handling, any run-time error that occurs is fatal: an error message is displayed, and execution stops. > [!NOTE] -> The `Error` keyword is also used in the [Error Statement](../../../visual-basic/language-reference/statements/error-statement.md), which is supported for backward compatibility. +> The `Error` keyword is also used in the [Error Statement](error-statement.md), which is supported for backward compatibility. ## Syntax @@ -49,7 +49,7 @@ On Error { GoTo [ line | 0 | -1 ] | Resume Next } ## Remarks > [!NOTE] -> We recommend that you use structured exception handling in your code whenever possible, rather than using unstructured exception handling and the `On Error` statement. For more information, see [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md). +> We recommend that you use structured exception handling in your code whenever possible, rather than using unstructured exception handling and the `On Error` statement. For more information, see [Try...Catch...Finally Statement](try-catch-finally-statement.md). An "enabled" error handler is one that is turned on by an `On Error` statement. An "active" error handler is an enabled handler that is in the process of handling an error. @@ -106,7 +106,7 @@ On Error { GoTo [ line | 0 | -1 ] | Resume Next } [!code-vb[VbVbalrErrorHandling#20](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrErrorHandling/VB/Class1.vb#20)] ## Requirements - **Namespace:** [Microsoft.VisualBasic](../../../visual-basic/language-reference/runtime-library-members.md) + **Namespace:** [Microsoft.VisualBasic](../runtime-library-members.md) **Assembly:** Visual Basic Runtime Library (in Microsoft.VisualBasic.dll) @@ -116,8 +116,8 @@ On Error { GoTo [ line | 0 | -1 ] | Resume Next } - - - -- [End Statement](../../../visual-basic/language-reference/statements/end-statement.md) -- [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md) -- [Resume Statement](../../../visual-basic/language-reference/statements/resume-statement.md) -- [Error Messages](../../../visual-basic/language-reference/error-messages/index.md) -- [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) +- [End Statement](end-statement.md) +- [Exit Statement](exit-statement.md) +- [Resume Statement](resume-statement.md) +- [Error Messages](../error-messages/index.md) +- [Try...Catch...Finally Statement](try-catch-finally-statement.md) diff --git a/docs/visual-basic/language-reference/statements/operator-statement.md b/docs/visual-basic/language-reference/statements/operator-statement.md index dd9423e77d3c3..ba91024699ebf 100644 --- a/docs/visual-basic/language-reference/statements/operator-statement.md +++ b/docs/visual-basic/language-reference/statements/operator-statement.md @@ -37,25 +37,25 @@ End Operator ## Parts `attrlist` -Optional. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md). +Optional. See [Attribute List](attribute-list.md). `Public` -Required. Indicates that this operator procedure has [Public](../../../visual-basic/language-reference/modifiers/public.md) access. +Required. Indicates that this operator procedure has [Public](../modifiers/public.md) access. `Overloads` -Optional. See [Overloads](../../../visual-basic/language-reference/modifiers/overloads.md). +Optional. See [Overloads](../modifiers/overloads.md). `Shared` -Required. Indicates that this operator procedure is a [Shared](../../../visual-basic/language-reference/modifiers/shared.md) procedure. +Required. Indicates that this operator procedure is a [Shared](../modifiers/shared.md) procedure. `Shadows` -Optional. See [Shadows](../../../visual-basic/language-reference/modifiers/shadows.md). +Optional. See [Shadows](../modifiers/shadows.md). `Widening` -Required for a conversion operator unless you specify `Narrowing`. Indicates that this operator procedure defines a [Widening](../../../visual-basic/language-reference/modifiers/widening.md) conversion. See "Widening and Narrowing Conversions" on this Help page. +Required for a conversion operator unless you specify `Narrowing`. Indicates that this operator procedure defines a [Widening](../modifiers/widening.md) conversion. See "Widening and Narrowing Conversions" on this Help page. `Narrowing` -Required for a conversion operator unless you specify `Widening`. Indicates that this operator procedure defines a [Narrowing](../../../visual-basic/language-reference/modifiers/narrowing.md) conversion. See "Widening and Narrowing Conversions" on this Help page. +Required for a conversion operator unless you specify `Widening`. Indicates that this operator procedure defines a [Narrowing](../modifiers/narrowing.md) conversion. See "Widening and Narrowing Conversions" on this Help page. `operatorsymbol` Required. The symbol or identifier of the operator that this operator procedure defines. @@ -72,8 +72,8 @@ Required for binary operators. The name and type of the right operand of a binar |Part|Description| |----------|-----------------| -|`ByVal`|Optional, but the passing mechanism must be [ByVal](../../../visual-basic/language-reference/modifiers/byval.md).| -|`operandname`|Required. Name of the variable representing this operand. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md).| +|`ByVal`|Optional, but the passing mechanism must be [ByVal](../modifiers/byval.md).| +|`operandname`|Required. Name of the variable representing this operand. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md).| |`operandtype`|Optional unless `Option Strict` is `On`. Data type of this operand.| `type` @@ -90,7 +90,7 @@ Required. Terminates the definition of this operator procedure. ## Remarks -You can use `Operator` only in a class or structure. This means the *declaration context* for an operator cannot be a source file, namespace, module, interface, procedure, or block. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). +You can use `Operator` only in a class or structure. This means the *declaration context* for an operator cannot be a source file, namespace, module, interface, procedure, or block. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). All operators must be `Public Shared`. You cannot specify `ByRef`, `Optional`, or `ParamArray` for either operand. @@ -154,7 +154,7 @@ Similarly, you can use `OrElse` if you have defined `Or` on the same operands, w ## Widening and Narrowing Conversions -A *widening conversion* always succeeds at run time, while a *narrowing conversion* can fail at run time. For more information, see [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md). +A *widening conversion* always succeeds at run time, while a *narrowing conversion* can fail at run time. For more information, see [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md). If you declare a conversion procedure to be `Widening`, your procedure code must not generate any failures. This means the following: @@ -174,13 +174,13 @@ The following code example uses the `Operator` statement to define the outline o ## See also -- [IsFalse Operator](../../../visual-basic/language-reference/operators/isfalse-operator.md) -- [IsTrue Operator](../../../visual-basic/language-reference/operators/istrue-operator.md) -- [Widening](../../../visual-basic/language-reference/modifiers/widening.md) -- [Narrowing](../../../visual-basic/language-reference/modifiers/narrowing.md) -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) -- [Operator Procedures](../../../visual-basic/programming-guide/language-features/procedures/operator-procedures.md) -- [How to: Define an Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-an-operator.md) -- [How to: Define a Conversion Operator](../../../visual-basic/programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) -- [How to: Call an Operator Procedure](../../../visual-basic/programming-guide/language-features/procedures/how-to-call-an-operator-procedure.md) -- [How to: Use a Class that Defines Operators](../../../visual-basic/programming-guide/language-features/procedures/how-to-use-a-class-that-defines-operators.md) +- [IsFalse Operator](../operators/isfalse-operator.md) +- [IsTrue Operator](../operators/istrue-operator.md) +- [Widening](../modifiers/widening.md) +- [Narrowing](../modifiers/narrowing.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [Operator Procedures](../../programming-guide/language-features/procedures/operator-procedures.md) +- [How to: Define an Operator](../../programming-guide/language-features/procedures/how-to-define-an-operator.md) +- [How to: Define a Conversion Operator](../../programming-guide/language-features/procedures/how-to-define-a-conversion-operator.md) +- [How to: Call an Operator Procedure](../../programming-guide/language-features/procedures/how-to-call-an-operator-procedure.md) +- [How to: Use a Class that Defines Operators](../../programming-guide/language-features/procedures/how-to-use-a-class-that-defines-operators.md) diff --git a/docs/visual-basic/language-reference/statements/option-compare-statement.md b/docs/visual-basic/language-reference/statements/option-compare-statement.md index 31279a782327e..cf7a0ee0cbeec 100644 --- a/docs/visual-basic/language-reference/statements/option-compare-statement.md +++ b/docs/visual-basic/language-reference/statements/option-compare-statement.md @@ -53,7 +53,7 @@ Option Compare { Binary | Text } `(A=a) < (À = à) < (B=b) < (E=e) < (Ê = ê) < (Z=z) < (Ø = ø)` ## When an Option Compare Statement Is Not Present - If the source code does not contain an `Option Compare` statement, the **Option Compare** setting on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) is used. If you use the command-line compiler, the setting specified by the [-optioncompare](../../../visual-basic/reference/command-line-compiler/optioncompare.md) compiler option is used. + If the source code does not contain an `Option Compare` statement, the **Option Compare** setting on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) is used. If you use the command-line compiler, the setting specified by the [-optioncompare](../../reference/command-line-compiler/optioncompare.md) compiler option is used. [!INCLUDE[note_settings_general](~/includes/note-settings-general-md.md)] @@ -69,7 +69,7 @@ Option Compare { Binary | Text } #### To set Option Compare on the command line -- Include the [-optioncompare](../../../visual-basic/reference/command-line-compiler/optioncompare.md) compiler option in the **vbc** command. +- Include the [-optioncompare](../../reference/command-line-compiler/optioncompare.md) compiler option in the **vbc** command. ## Example The following example uses the `Option Compare` statement to set the binary comparison as the default string comparison method. To use this code, uncomment the `Option Compare Binary` statement, and put it at the top of the source file. @@ -88,10 +88,10 @@ Option Compare { Binary | Text } - - - -- [-optioncompare](../../../visual-basic/reference/command-line-compiler/optioncompare.md) -- [Comparison Operators](../../../visual-basic/language-reference/operators/comparison-operators.md) -- [Comparison Operators in Visual Basic](../../../visual-basic/programming-guide/language-features/operators-and-expressions/comparison-operators.md) -- [Like Operator](../../../visual-basic/language-reference/operators/like-operator.md) -- [String Functions](../../../visual-basic/language-reference/functions/string-functions.md) -- [Option Explicit Statement](../../../visual-basic/language-reference/statements/option-explicit-statement.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) +- [-optioncompare](../../reference/command-line-compiler/optioncompare.md) +- [Comparison Operators](../operators/comparison-operators.md) +- [Comparison Operators in Visual Basic](../../programming-guide/language-features/operators-and-expressions/comparison-operators.md) +- [Like Operator](../operators/like-operator.md) +- [String Functions](../functions/string-functions.md) +- [Option Explicit Statement](option-explicit-statement.md) +- [Option Strict Statement](option-strict-statement.md) diff --git a/docs/visual-basic/language-reference/statements/option-explicit-statement.md b/docs/visual-basic/language-reference/statements/option-explicit-statement.md index 45ac3872e8410..5ebd5d4b9e763 100644 --- a/docs/visual-basic/language-reference/statements/option-explicit-statement.md +++ b/docs/visual-basic/language-reference/statements/option-explicit-statement.md @@ -37,7 +37,7 @@ Option Explicit { On | Off } > Setting `Option Explicit` to `Off` is generally not a good practice. You could misspell a variable name in one or more locations, which would cause unexpected results when the program is run. ## When an Option Explicit Statement Is Not Present - If the source code does not contain an `Option Explicit` statement, the **Option Explicit** setting on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) is used. If the command-line compiler is used, the [-optionexplicit](../../../visual-basic/reference/command-line-compiler/optionexplicit.md) compiler option is used. + If the source code does not contain an `Option Explicit` statement, the **Option Explicit** setting on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) is used. If the command-line compiler is used, the [-optionexplicit](../../reference/command-line-compiler/optionexplicit.md) compiler option is used. #### To set Option Explicit in the IDE @@ -51,7 +51,7 @@ Option Explicit { On | Off } #### To set Option Explicit on the command line -- Include the [-optionexplicit](../../../visual-basic/reference/command-line-compiler/optionexplicit.md) compiler option in the **vbc** command. +- Include the [-optionexplicit](../../reference/command-line-compiler/optionexplicit.md) compiler option in the **vbc** command. ## Example The following example uses the `Option Explicit` statement to force explicit declaration of all variables. Attempting to use an undeclared variable causes an error at compile time. @@ -62,11 +62,11 @@ Option Explicit { On | Off } ## See also -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) -- [ReDim Statement](../../../visual-basic/language-reference/statements/redim-statement.md) -- [Option Compare Statement](../../../visual-basic/language-reference/statements/option-compare-statement.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) -- [-optioncompare](../../../visual-basic/reference/command-line-compiler/optioncompare.md) -- [-optionexplicit](../../../visual-basic/reference/command-line-compiler/optionexplicit.md) -- [-optionstrict](../../../visual-basic/reference/command-line-compiler/optionstrict.md) +- [Dim Statement](dim-statement.md) +- [ReDim Statement](redim-statement.md) +- [Option Compare Statement](option-compare-statement.md) +- [Option Strict Statement](option-strict-statement.md) +- [-optioncompare](../../reference/command-line-compiler/optioncompare.md) +- [-optionexplicit](../../reference/command-line-compiler/optionexplicit.md) +- [-optionstrict](../../reference/command-line-compiler/optionstrict.md) - [Visual Basic Defaults, Projects, Options Dialog Box](/visualstudio/ide/reference/visual-basic-defaults-projects-options-dialog-box) diff --git a/docs/visual-basic/language-reference/statements/option-infer-statement.md b/docs/visual-basic/language-reference/statements/option-infer-statement.md index 416c273ccea02..baca82c82bab5 100644 --- a/docs/visual-basic/language-reference/statements/option-infer-statement.md +++ b/docs/visual-basic/language-reference/statements/option-infer-statement.md @@ -52,11 +52,11 @@ The following screenshot shows IntelliSense when Option Infer is off: Type inference applies at the procedure level, and does not apply outside a procedure in a class, structure, module, or interface. -For additional information, see [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md). +For additional information, see [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md). ## When an Option Infer Statement Is Not Present -If the source code does not contain an `Option Infer` statement, the **Option Infer** setting on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) is used. If the command-line compiler is used, the [-optioninfer](../../../visual-basic/reference/command-line-compiler/optioninfer.md) compiler option is used. +If the source code does not contain an `Option Infer` statement, the **Option Infer** setting on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) is used. If the command-line compiler is used, the [-optioninfer](../../reference/command-line-compiler/optioninfer.md) compiler option is used. #### To set Option Infer in the IDE @@ -70,7 +70,7 @@ When you create a new project, the **Option Infer** setting on the **Compile** t #### To set Option Infer on the command line -Include the [-optioninfer](../../../visual-basic/reference/command-line-compiler/optioninfer.md) compiler option in the **vbc** command. +Include the [-optioninfer](../../reference/command-line-compiler/optioninfer.md) compiler option in the **vbc** command. ## Default Data Types and Values @@ -79,8 +79,8 @@ The following table describes the results of various combinations of specifying |Data type specified?|Initializer specified?|Example|Result| |---|---|---|---| |No|No|`Dim qty`|If `Option Strict` is off (the default), the variable is set to `Nothing`.

If `Option Strict` is on, a compile-time error occurs.| -|No|Yes|`Dim qty = 5`|If `Option Infer` is on (the default), the variable takes the data type of the initializer. See [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md).

If `Option Infer` is off and `Option Strict` is off, the variable takes the data type of `Object`.

If `Option Infer` is off and `Option Strict` is on, a compile-time error occurs.| -|Yes|No|`Dim qty As Integer`|The variable is initialized to the default value for the data type. For more information, see [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md).| +|No|Yes|`Dim qty = 5`|If `Option Infer` is on (the default), the variable takes the data type of the initializer. See [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md).

If `Option Infer` is off and `Option Strict` is off, the variable takes the data type of `Object`.

If `Option Infer` is off and `Option Strict` is on, a compile-time error occurs.| +|Yes|No|`Dim qty As Integer`|The variable is initialized to the default value for the data type. For more information, see [Dim Statement](dim-statement.md).| |Yes|Yes|`Dim qty As Integer = 5`|If the data type of the initializer is not convertible to the specified data type, a compile-time error occurs.| ## Example @@ -97,11 +97,11 @@ The following example demonstrates that the run-time type can differ when a vari ## See also -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) -- [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md) -- [Option Compare Statement](../../../visual-basic/language-reference/statements/option-compare-statement.md) -- [Option Explicit Statement](../../../visual-basic/language-reference/statements/option-explicit-statement.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) +- [Dim Statement](dim-statement.md) +- [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md) +- [Option Compare Statement](option-compare-statement.md) +- [Option Explicit Statement](option-explicit-statement.md) +- [Option Strict Statement](option-strict-statement.md) - [Visual Basic Defaults, Projects, Options Dialog Box](/visualstudio/ide/reference/visual-basic-defaults-projects-options-dialog-box) -- [-optioninfer](../../../visual-basic/reference/command-line-compiler/optioninfer.md) +- [-optioninfer](../../reference/command-line-compiler/optioninfer.md) - [Boxing and Unboxing](../../../csharp/programming-guide/types/boxing-and-unboxing.md) diff --git a/docs/visual-basic/language-reference/statements/option-keyword-statement.md b/docs/visual-basic/language-reference/statements/option-keyword-statement.md index a5086eba62ea7..075f848894940 100644 --- a/docs/visual-basic/language-reference/statements/option-keyword-statement.md +++ b/docs/visual-basic/language-reference/statements/option-keyword-statement.md @@ -15,14 +15,14 @@ Introduces a statement that specifies a compiler option that applies to the enti The `Option` keyword can be used in these contexts: - [Option Compare Statement](../../../visual-basic/language-reference/statements/option-compare-statement.md) + [Option Compare Statement](option-compare-statement.md) - [Option Explicit Statement](../../../visual-basic/language-reference/statements/option-explicit-statement.md) + [Option Explicit Statement](option-explicit-statement.md) - [Option Infer Statement](../../../visual-basic/language-reference/statements/option-infer-statement.md) + [Option Infer Statement](option-infer-statement.md) - [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) + [Option Strict Statement](option-strict-statement.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/statements/option-strict-statement.md b/docs/visual-basic/language-reference/statements/option-strict-statement.md index ce9448a3c16e5..8cdc515054a95 100644 --- a/docs/visual-basic/language-reference/statements/option-strict-statement.md +++ b/docs/visual-basic/language-reference/statements/option-strict-statement.md @@ -38,7 +38,7 @@ Option Strict { On | Off } - Implicit typing that results in an `Object` type > [!NOTE] -> In the warning configurations that you can set on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic), there are three settings that correspond to the three conditions that cause a compile-time error. For information about how to use these settings, see [To set warning configurations in the IDE](../../../visual-basic/language-reference/statements/option-strict-statement.md#conditions) later in this topic. +> In the warning configurations that you can set on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic), there are three settings that correspond to the three conditions that cause a compile-time error. For information about how to use these settings, see [To set warning configurations in the IDE](option-strict-statement.md#conditions) later in this topic. The `Option Strict Off` statement turns off error and warning checking for all three conditions, even if the associated IDE settings specify to turn on these errors or warnings. The `Option Strict On` statement turns on error and warning checking for all three conditions, even if the associated IDE settings specify to turn off these errors or warnings. @@ -55,50 +55,50 @@ Option Strict { On | Off } ## Implicit Narrowing Conversion Errors Implicit narrowing conversion errors occur when there is an implicit data type conversion that is a narrowing conversion. - Visual Basic can convert many data types to other data types. Data loss can occur when the value of one data type is converted to a data type that has less precision or a smaller capacity. A run-time error occurs if such a narrowing conversion fails. `Option Strict` ensures compile-time notification of these narrowing conversions so that you can avoid them. For more information, see [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) and [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md). + Visual Basic can convert many data types to other data types. Data loss can occur when the value of one data type is converted to a data type that has less precision or a smaller capacity. A run-time error occurs if such a narrowing conversion fails. `Option Strict` ensures compile-time notification of these narrowing conversions so that you can avoid them. For more information, see [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) and [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md). Conversions that can cause errors include implicit conversions that occur in expressions. For more information, see the following topics: -- [+ Operator](../../../visual-basic/language-reference/operators/addition-operator.md) +- [+ Operator](../operators/addition-operator.md) -- [+= Operator](../../../visual-basic/language-reference/operators/addition-assignment-operator.md) +- [+= Operator](../operators/addition-assignment-operator.md) -- [\ Operator (Visual Basic)](../../../visual-basic/language-reference/operators/integer-division-operator.md) +- [\ Operator (Visual Basic)](../operators/integer-division-operator.md) -- [/= Operator (Visual Basic)](../../../visual-basic/language-reference/operators/floating-point-division-assignment-operator.md) +- [/= Operator (Visual Basic)](../operators/floating-point-division-assignment-operator.md) -- [Char Data Type](../../../visual-basic/language-reference/data-types/char-data-type.md) +- [Char Data Type](../data-types/char-data-type.md) - When you concatenate strings by using the [& Operator](../../../visual-basic/language-reference/operators/concatenation-operator.md), all conversions to the strings are considered to be widening. So these conversions do not generate an implicit narrowing conversion error, even if `Option Strict` is on. + When you concatenate strings by using the [& Operator](../operators/concatenation-operator.md), all conversions to the strings are considered to be widening. So these conversions do not generate an implicit narrowing conversion error, even if `Option Strict` is on. When you call a method that has an argument that has a data type different from the corresponding parameter, a narrowing conversion causes a compile-time error if `Option Strict` is on. You can avoid the compile-time error by using a widening conversion or an explicit conversion. - Implicit narrowing conversion errors are suppressed at compile-time for conversions from the elements in a `For Each…Next` collection to the loop control variable. This occurs even if `Option Strict` is on. For more information, see the "Narrowing Conversions" section in [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md). + Implicit narrowing conversion errors are suppressed at compile-time for conversions from the elements in a `For Each…Next` collection to the loop control variable. This occurs even if `Option Strict` is on. For more information, see the "Narrowing Conversions" section in [For Each...Next Statement](for-each-next-statement.md). ## Late Binding Errors - An object is late bound when it is assigned to a property or method of a variable that is declared to be of type `Object`. For more information, see [Early and Late Binding](../../../visual-basic/programming-guide/language-features/early-late-binding/index.md). + An object is late bound when it is assigned to a property or method of a variable that is declared to be of type `Object`. For more information, see [Early and Late Binding](../../programming-guide/language-features/early-late-binding/index.md). ## Implicit Object Type Errors - Implicit object type errors occur when an appropriate type cannot be inferred for a declared variable, so a type of `Object` is inferred. This primarily occurs when you use a `Dim` statement to declare a variable without using an `As` clause, and `Option Infer` is off. For more information, see [Option Infer Statement](../../../visual-basic/language-reference/statements/option-infer-statement.md) and the [Visual Basic Language Specification](../../../visual-basic/reference/language-specification/index.md). + Implicit object type errors occur when an appropriate type cannot be inferred for a declared variable, so a type of `Object` is inferred. This primarily occurs when you use a `Dim` statement to declare a variable without using an `As` clause, and `Option Infer` is off. For more information, see [Option Infer Statement](option-infer-statement.md) and the [Visual Basic Language Specification](../../reference/language-specification/index.md). For method parameters, the `As` clause is optional if `Option Strict` is off. However, if any one parameter uses an `As` clause, they all must use it. If `Option Strict` is on, the `As` clause is required for every parameter definition. If you declare a variable without using an `As` clause and set it to `Nothing`, the variable has a type of `Object`. No compile-time error occurs in this case when `Option Strict` is on and `Option Infer` is on. An example of this is `Dim something = Nothing`. ### Default Data Types and Values - The following table describes the results of various combinations of specifying the data type and initializer in a [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md). + The following table describes the results of various combinations of specifying the data type and initializer in a [Dim Statement](dim-statement.md). |Data type specified?|Initializer specified?|Example|Result| |---|---|---|---| |No|No|`Dim qty`|If `Option Strict` is off (the default), the variable is set to `Nothing`.

If `Option Strict` is on, a compile-time error occurs.| -|No|Yes|`Dim qty = 5`|If `Option Infer` is on (the default), the variable takes the data type of the initializer. See [Local Type Inference](../../../visual-basic/programming-guide/language-features/variables/local-type-inference.md).

If `Option Infer` is off and `Option Strict` is off, the variable takes the data type of `Object`.

If `Option Infer` is off and `Option Strict` is on, a compile-time error occurs.| -|Yes|No|`Dim qty As Integer`|The variable is initialized to the default value for the data type. For more information, see [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md).| +|No|Yes|`Dim qty = 5`|If `Option Infer` is on (the default), the variable takes the data type of the initializer. See [Local Type Inference](../../programming-guide/language-features/variables/local-type-inference.md).

If `Option Infer` is off and `Option Strict` is off, the variable takes the data type of `Object`.

If `Option Infer` is off and `Option Strict` is on, a compile-time error occurs.| +|Yes|No|`Dim qty As Integer`|The variable is initialized to the default value for the data type. For more information, see [Dim Statement](dim-statement.md).| |Yes|Yes|`Dim qty As Integer = 5`|If the data type of the initializer is not convertible to the specified data type, a compile-time error occurs.| ## When an Option Strict Statement Is Not Present If the source code does not contain an `Option Strict` statement, the **Option strict** setting on the [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) is used. The **Compile Page** has settings that provide additional control over the conditions that generate an error. - If you are using the command-line compiler, you can use the [-optionstrict](../../../visual-basic/reference/command-line-compiler/optionstrict.md) compiler option to specify a setting for `Option Strict`. + If you are using the command-line compiler, you can use the [-optionstrict](../../reference/command-line-compiler/optionstrict.md) compiler option to specify a setting for `Option Strict`. ### To set Option Strict in the IDE [!INCLUDE[note_settings_general](~/includes/note-settings-general-md.md)] @@ -126,7 +126,7 @@ Option Strict { On | Off } To set `Option Strict` in this dialog box, on the **Tools** menu, click **Options**. In the **Options** dialog box, expand **Projects and Solutions**, and then click **VB Defaults**. The initial default setting in **VB Defaults** is `Off`. ### To set Option Strict on the command line - Include the [-optionstrict](../../../visual-basic/reference/command-line-compiler/optionstrict.md) compiler option in the **vbc** command. + Include the [-optionstrict](../../reference/command-line-compiler/optionstrict.md) compiler option in the **vbc** command. ## Example The following examples demonstrate compile-time errors caused by implicit type conversions that are narrowing conversions. This category of errors corresponds to the **Implicit conversion** condition on the **Compile Page**. @@ -147,14 +147,14 @@ Option Strict { On | Off } ## See also -- [Widening and Narrowing Conversions](../../../visual-basic/programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) -- [Implicit and Explicit Conversions](../../../visual-basic/programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) +- [Widening and Narrowing Conversions](../../programming-guide/language-features/data-types/widening-and-narrowing-conversions.md) +- [Implicit and Explicit Conversions](../../programming-guide/language-features/data-types/implicit-and-explicit-conversions.md) - [Compile Page, Project Designer (Visual Basic)](/visualstudio/ide/reference/compile-page-project-designer-visual-basic) -- [Option Explicit Statement](../../../visual-basic/language-reference/statements/option-explicit-statement.md) -- [Type Conversion Functions](../../../visual-basic/language-reference/functions/type-conversion-functions.md) -- [How to: Access Members of an Object](../../../visual-basic/programming-guide/language-features/variables/how-to-access-members-of-an-object.md) -- [Embedded Expressions in XML](../../../visual-basic/programming-guide/language-features/xml/embedded-expressions-in-xml.md) -- [Relaxed Delegate Conversion](../../../visual-basic/programming-guide/language-features/delegates/relaxed-delegate-conversion.md) +- [Option Explicit Statement](option-explicit-statement.md) +- [Type Conversion Functions](../functions/type-conversion-functions.md) +- [How to: Access Members of an Object](../../programming-guide/language-features/variables/how-to-access-members-of-an-object.md) +- [Embedded Expressions in XML](../../programming-guide/language-features/xml/embedded-expressions-in-xml.md) +- [Relaxed Delegate Conversion](../../programming-guide/language-features/delegates/relaxed-delegate-conversion.md) - [Late Binding in Office Solutions](/visualstudio/vsto/late-binding-in-office-solutions) -- [-optionstrict](../../../visual-basic/reference/command-line-compiler/optionstrict.md) +- [-optionstrict](../../reference/command-line-compiler/optionstrict.md) - [Visual Basic Defaults, Projects, Options Dialog Box](/visualstudio/ide/reference/visual-basic-defaults-projects-options-dialog-box) diff --git a/docs/visual-basic/language-reference/statements/parameter-list.md b/docs/visual-basic/language-reference/statements/parameter-list.md index 6c35ebeeb1219..179ae3be2d0e7 100644 --- a/docs/visual-basic/language-reference/statements/parameter-list.md +++ b/docs/visual-basic/language-reference/statements/parameter-list.md @@ -25,7 +25,7 @@ parametername[( )] [ As parametertype ] [ = defaultvalue ] ## Parts `attributelist` -Optional. List of attributes that apply to this parameter. You must enclose the [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md) in angle brackets ("`<`" and "`>`"). +Optional. List of attributes that apply to this parameter. You must enclose the [Attribute List](attribute-list.md) in angle brackets ("`<`" and "`>`"). `Optional` Optional. Specifies that this parameter is not required when the procedure is called. @@ -52,11 +52,11 @@ Required for `Optional` parameters. Any constant or constant expression that eva Parameters are surrounded by parentheses and separated by commas. A parameter can be declared with any data type. If you do not specify `parametertype`, it defaults to `Object`. -When the calling code calls the procedure, it passes an *argument* to each required parameter. For more information, see [Differences Between Parameters and Arguments](../../../visual-basic/programming-guide/language-features/procedures/differences-between-parameters-and-arguments.md). +When the calling code calls the procedure, it passes an *argument* to each required parameter. For more information, see [Differences Between Parameters and Arguments](../../programming-guide/language-features/procedures/differences-between-parameters-and-arguments.md). -The argument the calling code passes to each parameter is a pointer to an underlying element in the calling code. If this element is *nonvariable* (a constant, literal, enumeration, or expression), it is impossible for any code to change it. If it is a *variable* element (a declared variable, field, property, array element, or structure element), the calling code can change it. For more information, see [Differences Between Modifiable and Nonmodifiable Arguments](../../../visual-basic/programming-guide/language-features/procedures/differences-between-modifiable-and-nonmodifiable-arguments.md). +The argument the calling code passes to each parameter is a pointer to an underlying element in the calling code. If this element is *nonvariable* (a constant, literal, enumeration, or expression), it is impossible for any code to change it. If it is a *variable* element (a declared variable, field, property, array element, or structure element), the calling code can change it. For more information, see [Differences Between Modifiable and Nonmodifiable Arguments](../../programming-guide/language-features/procedures/differences-between-modifiable-and-nonmodifiable-arguments.md). -If a variable element is passed `ByRef`, the procedure can change it as well. For more information, see [Differences Between Passing an Argument By Value and By Reference](../../../visual-basic/programming-guide/language-features/procedures/differences-between-passing-an-argument-by-value-and-by-reference.md). +If a variable element is passed `ByRef`, the procedure can change it as well. For more information, see [Differences Between Passing an Argument By Value and By Reference](../../programming-guide/language-features/procedures/differences-between-passing-an-argument-by-value-and-by-reference.md). ## Rules @@ -66,17 +66,17 @@ If a variable element is passed `ByRef`, the procedure can change it as well. Fo Every optional parameter declaration must supply the `defaultvalue` clause. - For more information, see [Optional Parameters](../../../visual-basic/programming-guide/language-features/procedures/optional-parameters.md). + For more information, see [Optional Parameters](../../programming-guide/language-features/procedures/optional-parameters.md). - **Parameter Arrays.** You must specify `ByVal` for a `ParamArray` parameter. You cannot use both `Optional` and `ParamArray` in the same parameter list. - For more information, see [Parameter Arrays](../../../visual-basic/programming-guide/language-features/procedures/parameter-arrays.md). + For more information, see [Parameter Arrays](../../programming-guide/language-features/procedures/parameter-arrays.md). - **Passing Mechanism.** The default mechanism for every argument is `ByVal`, which means the procedure cannot change the underlying variable element. However, if the element is a reference type, the procedure can modify the contents or members of the underlying object, even though it cannot replace or reassign the object itself. -- **Parameter Names.** If the parameter's data type is an array, follow `parametername` immediately by parentheses. For more information on parameter names, see [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). +- **Parameter Names.** If the parameter's data type is an array, follow `parametername` immediately by parentheses. For more information on parameter names, see [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). ## Example @@ -87,10 +87,10 @@ The following example shows a `Function` procedure that defines two parameters. ## See also - -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Declare Statement](../../../visual-basic/language-reference/statements/declare-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) -- [Option Strict Statement](../../../visual-basic/language-reference/statements/option-strict-statement.md) -- [Attributes overview](../../../visual-basic/programming-guide/concepts/attributes/index.md) -- [How to: Break and Combine Statements in Code](../../../visual-basic/programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) +- [Function Statement](function-statement.md) +- [Sub Statement](sub-statement.md) +- [Declare Statement](declare-statement.md) +- [Structure Statement](structure-statement.md) +- [Option Strict Statement](option-strict-statement.md) +- [Attributes overview](../../programming-guide/concepts/attributes/index.md) +- [How to: Break and Combine Statements in Code](../../programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) diff --git a/docs/visual-basic/language-reference/statements/q-z-statements.md b/docs/visual-basic/language-reference/statements/q-z-statements.md index 91e4c9eeaeda7..78c9cbb871221 100644 --- a/docs/visual-basic/language-reference/statements/q-z-statements.md +++ b/docs/visual-basic/language-reference/statements/q-z-statements.md @@ -8,14 +8,14 @@ The following table contains a listing of Visual Basic language statements. ||||| |---|---|---|---| -|[RaiseEvent](../../../visual-basic/language-reference/statements/raiseevent-statement.md)|[ReDim](../../../visual-basic/language-reference/statements/redim-statement.md)|[REM](../../../visual-basic/language-reference/statements/rem-statement.md)|[RemoveHandler](../../../visual-basic/language-reference/statements/removehandler-statement.md)| -|[Resume](../../../visual-basic/language-reference/statements/resume-statement.md)|[Return](../../../visual-basic/language-reference/statements/return-statement.md)|[Select...Case](../../../visual-basic/language-reference/statements/select-case-statement.md)|[Set](../../../visual-basic/language-reference/statements/set-statement.md)| -|[Stop](../../../visual-basic/language-reference/statements/stop-statement.md)|[Structure](../../../visual-basic/language-reference/statements/structure-statement.md)|[Sub](../../../visual-basic/language-reference/statements/sub-statement.md)|[SyncLock](../../../visual-basic/language-reference/statements/synclock-statement.md)| -|[Then](../../../visual-basic/language-reference/statements/then-statement.md)|[Throw](../../../visual-basic/language-reference/statements/throw-statement.md)|[Try...Catch...Finally](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md)|[Using](../../../visual-basic/language-reference/statements/using-statement.md)| -|[While...End While](../../../visual-basic/language-reference/statements/while-end-while-statement.md)|[With...End With](../../../visual-basic/language-reference/statements/with-end-with-statement.md)|[Yield](../../../visual-basic/language-reference/statements/yield-statement.md)|| +|[RaiseEvent](raiseevent-statement.md)|[ReDim](redim-statement.md)|[REM](rem-statement.md)|[RemoveHandler](removehandler-statement.md)| +|[Resume](resume-statement.md)|[Return](return-statement.md)|[Select...Case](select-case-statement.md)|[Set](set-statement.md)| +|[Stop](stop-statement.md)|[Structure](structure-statement.md)|[Sub](sub-statement.md)|[SyncLock](synclock-statement.md)| +|[Then](then-statement.md)|[Throw](throw-statement.md)|[Try...Catch...Finally](try-catch-finally-statement.md)|[Using](using-statement.md)| +|[While...End While](while-end-while-statement.md)|[With...End With](with-end-with-statement.md)|[Yield](yield-statement.md)|| ## See also -- [A-E Statements](../../../visual-basic/language-reference/statements/a-e-statements.md) -- [F-P Statements](../../../visual-basic/language-reference/statements/f-p-statements.md) -- [Visual Basic Language Reference](../../../visual-basic/language-reference/index.md) +- [A-E Statements](a-e-statements.md) +- [F-P Statements](f-p-statements.md) +- [Visual Basic Language Reference](../index.md) diff --git a/docs/visual-basic/language-reference/statements/raiseevent-statement.md b/docs/visual-basic/language-reference/statements/raiseevent-statement.md index ce4a8c24cf7ed..ae1673b79835e 100644 --- a/docs/visual-basic/language-reference/statements/raiseevent-statement.md +++ b/docs/visual-basic/language-reference/statements/raiseevent-statement.md @@ -42,7 +42,7 @@ RaiseEvent eventname[( argumentlist )] > Non-shared events should not be raised within the constructor of the class in which they are declared. Although such events do not cause run-time errors, they may fail to be caught by associated event handlers. Use the `Shared` modifier to create a shared event if you need to raise an event from a constructor. > [!NOTE] -> You can change the default behavior of events by defining a custom event. For custom events, the `RaiseEvent` statement invokes the event's `RaiseEvent` accessor. For more information on custom events, see [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md). +> You can change the default behavior of events by defining a custom event. For custom events, the `RaiseEvent` statement invokes the event's `RaiseEvent` accessor. For more information on custom events, see [Event Statement](event-statement.md). ## Example The following example uses events to count down seconds from 10 to 0. The code illustrates several of the event-related methods, properties, and statements, including the `RaiseEvent` statement. @@ -71,8 +71,8 @@ RaiseEvent eventname[( argumentlist )] ## See also -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [AddHandler Statement](../../../visual-basic/language-reference/statements/addhandler-statement.md) -- [RemoveHandler Statement](../../../visual-basic/language-reference/statements/removehandler-statement.md) -- [Handles](../../../visual-basic/language-reference/statements/handles-clause.md) +- [Events](../../programming-guide/language-features/events/index.md) +- [Event Statement](event-statement.md) +- [AddHandler Statement](addhandler-statement.md) +- [RemoveHandler Statement](removehandler-statement.md) +- [Handles](handles-clause.md) diff --git a/docs/visual-basic/language-reference/statements/redim-statement.md b/docs/visual-basic/language-reference/statements/redim-statement.md index 597fa32682cf4..247957c61a99e 100644 --- a/docs/visual-basic/language-reference/statements/redim-statement.md +++ b/docs/visual-basic/language-reference/statements/redim-statement.md @@ -41,7 +41,7 @@ ReDim [ Preserve ] name(boundlist) [ , name(boundlist) [, ... ] ] |Term|Definition| |----------|----------------| |`Preserve`|Optional. Modifier used to preserve the data in the existing array when you change the size of only the last dimension.| -|`name`|Required. Name of the array variable. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md).| +|`name`|Required. Name of the array variable. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md).| |`boundlist`|Required. List of bounds of each dimension of the redefined array.| ## Remarks @@ -49,7 +49,7 @@ ReDim [ Preserve ] name(boundlist) [ , name(boundlist) [, ... ] ] The `ReDim` statement is intended only for arrays. It's not valid on scalars (variables that contain only a single value), collections, or structures. Note that if you declare a variable to be of type `Array`, the `ReDim` statement doesn't have sufficient type information to create the new array. - You can use `ReDim` only at procedure level. Therefore, the declaration context for the variable must be a procedure; it can't be a source file, a namespace, an interface, a class, a structure, a module, or a block. For more information, see [Declaration Contexts and Default Access Levels](../../../visual-basic/language-reference/statements/declaration-contexts-and-default-access-levels.md). + You can use `ReDim` only at procedure level. Therefore, the declaration context for the variable must be a procedure; it can't be a source file, a namespace, an interface, a class, a structure, a module, or a block. For more information, see [Declaration Contexts and Default Access Levels](declaration-contexts-and-default-access-levels.md). ## Rules @@ -92,13 +92,13 @@ ReDim [ Preserve ] name(boundlist) [ , name(boundlist) [, ... ] ] The third `ReDim` creates another new array and removes another five columns from the end of every row in every layer. This time it does not copy any existing elements. This statement reverts the array to its original size. Because the statement doesn't include the `Preserve` modifier, it sets all array elements to their original default values. - For additional examples, see [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md). + For additional examples, see [Arrays](../../programming-guide/language-features/arrays/index.md). ## See also - -- [Const Statement](../../../visual-basic/language-reference/statements/const-statement.md) -- [Dim Statement](../../../visual-basic/language-reference/statements/dim-statement.md) -- [Erase Statement](../../../visual-basic/language-reference/statements/erase-statement.md) -- [Nothing](../../../visual-basic/language-reference/nothing.md) -- [Arrays](../../../visual-basic/programming-guide/language-features/arrays/index.md) +- [Const Statement](const-statement.md) +- [Dim Statement](dim-statement.md) +- [Erase Statement](erase-statement.md) +- [Nothing](../nothing.md) +- [Arrays](../../programming-guide/language-features/arrays/index.md) diff --git a/docs/visual-basic/language-reference/statements/rem-statement.md b/docs/visual-basic/language-reference/statements/rem-statement.md index 4fd3c7938fc7b..916e92da1f573 100644 --- a/docs/visual-basic/language-reference/statements/rem-statement.md +++ b/docs/visual-basic/language-reference/statements/rem-statement.md @@ -43,5 +43,5 @@ REM comment ## See also -- [Comments in Code](../../../visual-basic/programming-guide/program-structure/comments-in-code.md) -- [How to: Break and Combine Statements in Code](../../../visual-basic/programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) +- [Comments in Code](../../programming-guide/program-structure/comments-in-code.md) +- [How to: Break and Combine Statements in Code](../../programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) diff --git a/docs/visual-basic/language-reference/statements/removehandler-statement.md b/docs/visual-basic/language-reference/statements/removehandler-statement.md index 853d9957735db..0e8fdb397a8aa 100644 --- a/docs/visual-basic/language-reference/statements/removehandler-statement.md +++ b/docs/visual-basic/language-reference/statements/removehandler-statement.md @@ -30,14 +30,14 @@ RemoveHandler event, AddressOf eventhandler The `AddHandler` and `RemoveHandler` statements allow you to start and stop event handling for a specific event at any time during program execution. > [!NOTE] -> For custom events, the `RemoveHandler` statement invokes the event's `RemoveHandler` accessor. For more information on custom events, see [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md). +> For custom events, the `RemoveHandler` statement invokes the event's `RemoveHandler` accessor. For more information on custom events, see [Event Statement](event-statement.md). ## Example [!code-vb[VbVbalrEvents#17](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrEvents/VB/Class1.vb#17)] ## See also -- [AddHandler Statement](../../../visual-basic/language-reference/statements/addhandler-statement.md) -- [Handles](../../../visual-basic/language-reference/statements/handles-clause.md) -- [Event Statement](../../../visual-basic/language-reference/statements/event-statement.md) -- [Events](../../../visual-basic/programming-guide/language-features/events/index.md) +- [AddHandler Statement](addhandler-statement.md) +- [Handles](handles-clause.md) +- [Event Statement](event-statement.md) +- [Events](../../programming-guide/language-features/events/index.md) diff --git a/docs/visual-basic/language-reference/statements/resume-statement.md b/docs/visual-basic/language-reference/statements/resume-statement.md index ad28511e73681..e0fe17ab962fa 100644 --- a/docs/visual-basic/language-reference/statements/resume-statement.md +++ b/docs/visual-basic/language-reference/statements/resume-statement.md @@ -19,7 +19,7 @@ ms.assetid: e24d058b-1a5c-4274-acb9-7d295d3ea537 # Resume Statement Resumes execution after an error-handling routine is finished. - We suggest that you use structured exception handling in your code whenever possible, rather than using unstructured exception handling and the `On Error` and `Resume` statements. For more information, see [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md). + We suggest that you use structured exception handling in your code whenever possible, rather than using unstructured exception handling and the `On Error` and `Resume` statements. For more information, see [Try...Catch...Finally Statement](try-catch-finally-statement.md). ## Syntax @@ -40,7 +40,7 @@ Resume [ Next | line ] ## Remarks > [!NOTE] -> We recommend that you use structured exception handling in your code whenever possible, rather than using unstructured exception handling and the `On Error` and `Resume` statements. For more information, see [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md). +> We recommend that you use structured exception handling in your code whenever possible, rather than using unstructured exception handling and the `On Error` and `Resume` statements. For more information, see [Try...Catch...Finally Statement](try-catch-finally-statement.md). If you use a `Resume` statement anywhere other than in an error-handling routine, an error occurs. @@ -52,12 +52,12 @@ Resume [ Next | line ] [!code-vb[VbVbalrErrorHandling#16](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrErrorHandling/VB/Class1.vb#16)] ## Requirements - **Namespace:** [Microsoft.VisualBasic](../../../visual-basic/language-reference/runtime-library-members.md) + **Namespace:** [Microsoft.VisualBasic](../runtime-library-members.md) **Assembly:** Visual Basic Runtime Library (in Microsoft.VisualBasic.dll) ## See also -- [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) -- [Error Statement](../../../visual-basic/language-reference/statements/error-statement.md) -- [On Error Statement](../../../visual-basic/language-reference/statements/on-error-statement.md) +- [Try...Catch...Finally Statement](try-catch-finally-statement.md) +- [Error Statement](error-statement.md) +- [On Error Statement](on-error-statement.md) diff --git a/docs/visual-basic/language-reference/statements/return-statement.md b/docs/visual-basic/language-reference/statements/return-statement.md index edb6c09214d2d..0507c84b670d8 100644 --- a/docs/visual-basic/language-reference/statements/return-statement.md +++ b/docs/visual-basic/language-reference/statements/return-statement.md @@ -42,11 +42,11 @@ Return expression ## See also -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Get Statement](../../../visual-basic/language-reference/statements/get-statement.md) -- [Set Statement](../../../visual-basic/language-reference/statements/set-statement.md) -- [Operator Statement](../../../visual-basic/language-reference/statements/operator-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md) -- [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) +- [Function Statement](function-statement.md) +- [Sub Statement](sub-statement.md) +- [Get Statement](get-statement.md) +- [Set Statement](set-statement.md) +- [Operator Statement](operator-statement.md) +- [Property Statement](property-statement.md) +- [Exit Statement](exit-statement.md) +- [Try...Catch...Finally Statement](try-catch-finally-statement.md) diff --git a/docs/visual-basic/language-reference/statements/select-case-statement.md b/docs/visual-basic/language-reference/statements/select-case-statement.md index 0fa594f7f8f15..719cd7459d04e 100644 --- a/docs/visual-basic/language-reference/statements/select-case-statement.md +++ b/docs/visual-basic/language-reference/statements/select-case-statement.md @@ -56,7 +56,7 @@ End Select `Case 1 To 4, 7 To 9, 11, 13, Is > maxNumber` > [!NOTE] -> The `Is` keyword used in the `Case` and `Case Else` statements is not the same as the [Is Operator](../../../visual-basic/language-reference/operators/is-operator.md), which is used for object reference comparison. +> The `Is` keyword used in the `Case` and `Case Else` statements is not the same as the [Is Operator](../operators/is-operator.md), which is used for object reference comparison. You can specify ranges and multiple expressions for character strings. In the following example, `Case` matches any string that is exactly equal to "apples", has a value between "nuts" and "soup" in alphabetical order, or contains the exact same value as the current value of `testItem`. @@ -65,7 +65,7 @@ End Select The setting of `Option Compare` can affect string comparisons. Under `Option Compare Text`, the strings "Apples" and "apples" compare as equal, but under `Option Compare Binary`, they do not. > [!NOTE] -> A `Case` statement with multiple clauses can exhibit behavior known as *short-circuiting*. Visual Basic evaluates the clauses from left to right, and if one produces a match with `testexpression`, the remaining clauses are not evaluated. Short-circuiting can improve performance, but it can produce unexpected results if you are expecting every expression in `expressionlist` to be evaluated. For more information on short-circuiting, see [Boolean Expressions](../../../visual-basic/programming-guide/language-features/operators-and-expressions/boolean-expressions.md). +> A `Case` statement with multiple clauses can exhibit behavior known as *short-circuiting*. Visual Basic evaluates the clauses from left to right, and if one produces a match with `testexpression`, the remaining clauses are not evaluated. Short-circuiting can improve performance, but it can produce unexpected results if you are expecting every expression in `expressionlist` to be evaluated. For more information on short-circuiting, see [Boolean Expressions](../../programming-guide/language-features/operators-and-expressions/boolean-expressions.md). If the code within a `Case` or `Case Else` statement block does not need to run any more of the statements in the block, it can exit the block by using the `Exit Select` statement. This transfers control immediately to the statement following `End Select`. @@ -79,7 +79,7 @@ End Select ## See also - -- [End Statement](../../../visual-basic/language-reference/statements/end-statement.md) -- [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) -- [Option Compare Statement](../../../visual-basic/language-reference/statements/option-compare-statement.md) -- [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md) +- [End Statement](end-statement.md) +- [If...Then...Else Statement](if-then-else-statement.md) +- [Option Compare Statement](option-compare-statement.md) +- [Exit Statement](exit-statement.md) diff --git a/docs/visual-basic/language-reference/statements/set-statement.md b/docs/visual-basic/language-reference/statements/set-statement.md index c6ed120030384..256a6f2b709b7 100644 --- a/docs/visual-basic/language-reference/statements/set-statement.md +++ b/docs/visual-basic/language-reference/statements/set-statement.md @@ -24,20 +24,20 @@ End Set ## Parts `attributelist` - Optional. See [Attribute List](../../../visual-basic/language-reference/statements/attribute-list.md). + Optional. See [Attribute List](attribute-list.md). `accessmodifier` Optional on at most one of the `Get` and `Set` statements in this property. Can be one of the following: -- [Protected](../../../visual-basic/language-reference/modifiers/protected.md) +- [Protected](../modifiers/protected.md) -- [Friend](../../../visual-basic/language-reference/modifiers/friend.md) +- [Friend](../modifiers/friend.md) -- [Private](../../../visual-basic/language-reference/modifiers/private.md) +- [Private](../modifiers/private.md) - `Protected Friend` - See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). + See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). `value` Required. Parameter containing the new value for the property. @@ -58,7 +58,7 @@ End Set Visual Basic passes a parameter to the `Set` procedure during property assignments. If you do not supply a parameter for `Set`, the integrated development environment (IDE) uses an implicit parameter named `value`. The parameter holds the value to be assigned to the property. You typically store this value in a private local variable and return it whenever the `Get` procedure is called. - The body of the property declaration can contain only the property's `Get` and `Set` procedures between the [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) and the `End Property` statement. It cannot store anything other than those procedures. In particular, it cannot store the property's current value. You must store this value outside the property, because if you store it inside either of the property procedures, the other property procedure cannot access it. The usual approach is to store the value in a [Private](../../../visual-basic/language-reference/modifiers/private.md) variable declared at the same level as the property. You must define a `Set` procedure inside the property to which it applies. + The body of the property declaration can contain only the property's `Get` and `Set` procedures between the [Property Statement](property-statement.md) and the `End Property` statement. It cannot store anything other than those procedures. In particular, it cannot store the property's current value. You must store this value outside the property, because if you store it inside either of the property procedures, the other property procedure cannot access it. The usual approach is to store the value in a [Private](../modifiers/private.md) variable declared at the same level as the property. You must define a `Set` procedure inside the property to which it applies. The `Set` procedure defaults to the access level of its containing property unless you use `accessmodifier` in the `Set` statement. @@ -72,7 +72,7 @@ End Set - **Returning from a Property Procedure.** When the `Set` procedure returns to the calling code, execution continues following the statement that provided the value to be stored. - `Set` property procedures can return using either the [Return Statement](../../../visual-basic/language-reference/statements/return-statement.md) or the [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md). + `Set` property procedures can return using either the [Return Statement](return-statement.md) or the [Exit Statement](exit-statement.md). The `Exit Property` and `Return` statements cause an immediate exit from a property procedure. Any number of `Exit Property` and `Return` statements can appear anywhere in the procedure, and you can mix `Exit Property` and `Return` statements. @@ -83,7 +83,7 @@ End Set ## See also -- [Get Statement](../../../visual-basic/language-reference/statements/get-statement.md) -- [Property Statement](../../../visual-basic/language-reference/statements/property-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [Property Procedures](../../../visual-basic/programming-guide/language-features/procedures/property-procedures.md) +- [Get Statement](get-statement.md) +- [Property Statement](property-statement.md) +- [Sub Statement](sub-statement.md) +- [Property Procedures](../../programming-guide/language-features/procedures/property-procedures.md) diff --git a/docs/visual-basic/language-reference/statements/stop-statement.md b/docs/visual-basic/language-reference/statements/stop-statement.md index 3ee2004fe2d48..97ad2db2b7fa9 100644 --- a/docs/visual-basic/language-reference/statements/stop-statement.md +++ b/docs/visual-basic/language-reference/statements/stop-statement.md @@ -37,4 +37,4 @@ Stop ## See also -- [End Statement](../../../visual-basic/language-reference/statements/end-statement.md) +- [End Statement](end-statement.md) diff --git a/docs/visual-basic/language-reference/statements/sub-statement.md b/docs/visual-basic/language-reference/statements/sub-statement.md index 604de4af83e1b..d25216c79c4e2 100644 --- a/docs/visual-basic/language-reference/statements/sub-statement.md +++ b/docs/visual-basic/language-reference/statements/sub-statement.md @@ -53,7 +53,7 @@ End Sub - `Partial` - Optional. Indicates definition of a partial method. See [Partial Methods](../../../visual-basic/programming-guide/language-features/procedures/partial-methods.md). + Optional. Indicates definition of a partial method. See [Partial Methods](../../programming-guide/language-features/procedures/partial-methods.md). - `accessmodifier` @@ -67,11 +67,11 @@ End Sub - [Private](../modifiers/private.md) - - [Protected Friend](../../language-reference/modifiers/protected-friend.md) + - [Protected Friend](../modifiers/protected-friend.md) - - [Private Protected](../../language-reference/modifiers/private-protected.md) + - [Private Protected](../modifiers/private-protected.md) - See [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md). + See [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md). - `proceduremodifiers` @@ -105,7 +105,7 @@ End Sub - `name` - Required. Name of the procedure. See [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). To create a constructor procedure for a class, set the name of a `Sub` procedure to the `New` keyword. For more information, see [Object Lifetime: How Objects Are Created and Destroyed](../../../visual-basic/programming-guide/language-features/objects-and-classes/object-lifetime-how-objects-are-created-and-destroyed.md). + Required. Name of the procedure. See [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). To create a constructor procedure for a class, set the name of a `Sub` procedure to the `New` keyword. For more information, see [Object Lifetime: How Objects Are Created and Destroyed](../../programming-guide/language-features/objects-and-classes/object-lifetime-how-objects-are-created-and-destroyed.md). - `typeparamlist` @@ -201,7 +201,7 @@ Visual Basic sometimes rearranges arithmetic expressions to increase internal ef By using the Async feature, you can invoke asynchronous functions without using explicit callbacks or manually splitting your code across multiple functions or lambda expressions. -If you mark a procedure with the [Async](../modifiers/async.md) modifier, you can use the [Await](../../../visual-basic/language-reference/operators/await-operator.md) operator in the procedure. When control reaches an `Await` expression in the `Async` procedure, control returns to the caller, and progress in the procedure is suspended until the awaited task completes. When the task is complete, execution can resume in the procedure. +If you mark a procedure with the [Async](../modifiers/async.md) modifier, you can use the [Await](../operators/await-operator.md) operator in the procedure. When control reaches an `Await` expression in the `Async` procedure, control returns to the caller, and progress in the procedure is suspended until the awaited task completes. When the task is complete, execution can resume in the procedure. > [!NOTE] > An `Async` procedure returns to the caller when either the first awaited object that’s not yet complete is encountered or the end of the `Async` procedure is reached, whichever occurs first. @@ -212,7 +212,7 @@ You can also mark a [Function Statement](function-statement.md) with the `Async` An `Async` procedure can't declare any [ByRef](../modifiers/byref.md) parameters. -For more information about `Async` procedures, see [Asynchronous Programming with Async and Await](../../../visual-basic/programming-guide/concepts/async/index.md), [Control Flow in Async Programs](../../../visual-basic/programming-guide/concepts/async/control-flow-in-async-programs.md), and [Async Return Types](../../../visual-basic/programming-guide/concepts/async/async-return-types.md). +For more information about `Async` procedures, see [Asynchronous Programming with Async and Await](../../programming-guide/concepts/async/index.md), [Control Flow in Async Programs](../../programming-guide/concepts/async/control-flow-in-async-programs.md), and [Async Return Types](../../programming-guide/concepts/async/async-return-types.md). ## Example @@ -236,7 +236,7 @@ The `startButton_Click` procedure is an example of an `Async Sub` procedure. Bec - [Dim Statement](dim-statement.md) - [Call Statement](call-statement.md) - [Of](of-clause.md) -- [Parameter Arrays](../../../visual-basic/programming-guide/language-features/procedures/parameter-arrays.md) -- [How to: Use a Generic Class](../../../visual-basic/programming-guide/language-features/data-types/how-to-use-a-generic-class.md) -- [Troubleshooting Procedures](../../../visual-basic/programming-guide/language-features/procedures/troubleshooting-procedures.md) -- [Partial Methods](../../../visual-basic/programming-guide/language-features/procedures/partial-methods.md) +- [Parameter Arrays](../../programming-guide/language-features/procedures/parameter-arrays.md) +- [How to: Use a Generic Class](../../programming-guide/language-features/data-types/how-to-use-a-generic-class.md) +- [Troubleshooting Procedures](../../programming-guide/language-features/procedures/troubleshooting-procedures.md) +- [Partial Methods](../../programming-guide/language-features/procedures/partial-methods.md) diff --git a/docs/visual-basic/language-reference/statements/synclock-statement.md b/docs/visual-basic/language-reference/statements/synclock-statement.md index ca610dd243f69..503eac12abbdf 100644 --- a/docs/visual-basic/language-reference/statements/synclock-statement.md +++ b/docs/visual-basic/language-reference/statements/synclock-statement.md @@ -46,7 +46,7 @@ End SyncLock You cannot change the value of `lockobject` while executing a `SyncLock` block. The mechanism requires that the lock object remain unchanged. -- You can't use the [Await](../../../visual-basic/language-reference/operators/await-operator.md) operator in a `SyncLock` block. +- You can't use the [Await](../operators/await-operator.md) operator in a `SyncLock` block. ## Behavior diff --git a/docs/visual-basic/language-reference/statements/then-statement.md b/docs/visual-basic/language-reference/statements/then-statement.md index 82087925c60cc..c0c1376d5e80f 100644 --- a/docs/visual-basic/language-reference/statements/then-statement.md +++ b/docs/visual-basic/language-reference/statements/then-statement.md @@ -11,10 +11,10 @@ Introduces a statement block to be compiled or executed if a tested condition is ## Remarks The `Then` keyword can be used in these contexts: - [#If...Then...#Else Directive](../../../visual-basic/language-reference/directives/if-then-else-directives.md) + [#If...Then...#Else Directive](../directives/if-then-else-directives.md) - [If...Then...Else Statement](../../../visual-basic/language-reference/statements/if-then-else-statement.md) + [If...Then...Else Statement](if-then-else-statement.md) ## See also -- [Keywords](../../../visual-basic/language-reference/keywords/index.md) +- [Keywords](../keywords/index.md) diff --git a/docs/visual-basic/language-reference/statements/throw-statement.md b/docs/visual-basic/language-reference/statements/throw-statement.md index d537ba80e1359..11e3a6ba10190 100644 --- a/docs/visual-basic/language-reference/statements/throw-statement.md +++ b/docs/visual-basic/language-reference/statements/throw-statement.md @@ -46,5 +46,5 @@ The following code uses the `Throw` statement to throw an exception: ## See also -- [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md) -- [On Error Statement](../../../visual-basic/language-reference/statements/on-error-statement.md) +- [Try...Catch...Finally Statement](try-catch-finally-statement.md) +- [On Error Statement](on-error-statement.md) diff --git a/docs/visual-basic/language-reference/statements/try-catch-finally-statement.md b/docs/visual-basic/language-reference/statements/try-catch-finally-statement.md index dc87a97ab4f87..5fac65a62317f 100644 --- a/docs/visual-basic/language-reference/statements/try-catch-finally-statement.md +++ b/docs/visual-basic/language-reference/statements/try-catch-finally-statement.md @@ -120,7 +120,7 @@ Ensure that code in `Catch` blocks can properly report exceptions to users, whet ## Async methods -If you mark a method with the [Async](../modifiers/async.md) modifier, you can use the [Await](../operators/await-operator.md) operator in the method. A statement with the `Await` operator suspends execution of the method until the awaited task completes. The task represents ongoing work. When the task that's associated with the `Await` operator finishes, execution resumes in the same method. For more information, see [Control Flow in Async Programs](../../../visual-basic/programming-guide/concepts/async/control-flow-in-async-programs.md). +If you mark a method with the [Async](../modifiers/async.md) modifier, you can use the [Await](../operators/await-operator.md) operator in the method. A statement with the `Await` operator suspends execution of the method until the awaited task completes. The task represents ongoing work. When the task that's associated with the `Await` operator finishes, execution resumes in the same method. For more information, see [Control Flow in Async Programs](../../programming-guide/concepts/async/control-flow-in-async-programs.md). A task returned by an Async method may end in a faulted state, indicating that it completed due to an unhandled exception. A task may also end in a canceled state, which results in an `OperationCanceledException` being thrown out of the await expression. To catch either type of exception, place the `Await` expression that's associated with the task in a `Try` block, and catch the exception in the `Catch` block. An example is provided later in this topic. diff --git a/docs/visual-basic/language-reference/statements/type-list.md b/docs/visual-basic/language-reference/statements/type-list.md index a990d00070011..d0412903e08e2 100644 --- a/docs/visual-basic/language-reference/statements/type-list.md +++ b/docs/visual-basic/language-reference/statements/type-list.md @@ -39,19 +39,19 @@ Specifies the *type parameters* for a *generic* programming element. Multiple pa |Term|Definition| |---|---| -|`genericmodifier`|Optional. Can be used only in generic interfaces and delegates. You can declare a type covariant by using the [Out](../../../visual-basic/language-reference/modifiers/out-generic-modifier.md) keyword or contravariant by using the [In](../../../visual-basic/language-reference/modifiers/in-generic-modifier.md) keyword. See [Covariance and Contravariance](../../programming-guide/concepts/covariance-contravariance/index.md).| +|`genericmodifier`|Optional. Can be used only in generic interfaces and delegates. You can declare a type covariant by using the [Out](../modifiers/out-generic-modifier.md) keyword or contravariant by using the [In](../modifiers/in-generic-modifier.md) keyword. See [Covariance and Contravariance](../../programming-guide/concepts/covariance-contravariance/index.md).| |`typename`|Required. Name of the type parameter. This is a placeholder, to be replaced by a defined type supplied by the corresponding type argument.| -|`constraintlist`|Optional. List of requirements that constrain the data type that can be supplied for `typename`. If you have multiple constraints, enclose them in curly braces (`{ }`) and separate them with commas. You must introduce the constraint list with the [As](../../../visual-basic/language-reference/statements/as-clause.md) keyword. You use `As` only once, at the beginning of the list.| +|`constraintlist`|Optional. List of requirements that constrain the data type that can be supplied for `typename`. If you have multiple constraints, enclose them in curly braces (`{ }`) and separate them with commas. You must introduce the constraint list with the [As](as-clause.md) keyword. You use `As` only once, at the beginning of the list.| ## Remarks Every generic programming element must take at least one type parameter. A type parameter is a placeholder for a specific type (a *constructed element*) that client code specifies when it creates an instance of the generic type. You can define a generic class, structure, interface, procedure, or delegate. -For more information on when to define a generic type, see [Generic Types in Visual Basic](../../../visual-basic/programming-guide/language-features/data-types/generic-types.md). For more information on type parameter names, see [Declared Element Names](../../../visual-basic/programming-guide/language-features/declared-elements/declared-element-names.md). +For more information on when to define a generic type, see [Generic Types in Visual Basic](../../programming-guide/language-features/data-types/generic-types.md). For more information on type parameter names, see [Declared Element Names](../../programming-guide/language-features/declared-elements/declared-element-names.md). ## Rules -- **Parentheses.** If you supply a type parameter list, you must enclose it in parentheses, and you must introduce the list with the [Of](../../../visual-basic/language-reference/statements/of-clause.md) keyword. You use `Of` only once, at the beginning of the list. +- **Parentheses.** If you supply a type parameter list, you must enclose it in parentheses, and you must introduce the list with the [Of](of-clause.md) keyword. You use `Of` only once, at the beginning of the list. - **Constraints.** A list of *constraints* on a type parameter can include the following items in any combination: @@ -71,7 +71,7 @@ For more information on when to define a generic type, see [Generic Types in Vis - **Compile-Time Substitution.** When you create a constructed type from a generic programming element, you supply a defined type for each type parameter. The Visual Basic compiler substitutes that supplied type for every occurrence of `typename` within the generic element. -- **Absence of Constraints.** If you do not specify any constraints on a type parameter, your code is limited to the operations and members supported by the [Object Data Type](../../../visual-basic/language-reference/data-types/object-data-type.md) for that type parameter. +- **Absence of Constraints.** If you do not specify any constraints on a type parameter, your code is limited to the operations and members supported by the [Object Data Type](../data-types/object-data-type.md) for that type parameter. ## Example @@ -93,14 +93,14 @@ The following example shows the equivalent skeleton definition generated by the ## See also -- [Of](../../../visual-basic/language-reference/statements/of-clause.md) -- [New Operator](../../../visual-basic/language-reference/operators/new-operator.md) -- [Access levels in Visual Basic](../../../visual-basic/programming-guide/language-features/declared-elements/access-levels.md) -- [Object Data Type](../../../visual-basic/language-reference/data-types/object-data-type.md) -- [Function Statement](../../../visual-basic/language-reference/statements/function-statement.md) -- [Structure Statement](../../../visual-basic/language-reference/statements/structure-statement.md) -- [Sub Statement](../../../visual-basic/language-reference/statements/sub-statement.md) -- [How to: Use a Generic Class](../../../visual-basic/programming-guide/language-features/data-types/how-to-use-a-generic-class.md) +- [Of](of-clause.md) +- [New Operator](../operators/new-operator.md) +- [Access levels in Visual Basic](../../programming-guide/language-features/declared-elements/access-levels.md) +- [Object Data Type](../data-types/object-data-type.md) +- [Function Statement](function-statement.md) +- [Structure Statement](structure-statement.md) +- [Sub Statement](sub-statement.md) +- [How to: Use a Generic Class](../../programming-guide/language-features/data-types/how-to-use-a-generic-class.md) - [Covariance and Contravariance](../../programming-guide/concepts/covariance-contravariance/index.md) -- [In](../../../visual-basic/language-reference/modifiers/in-generic-modifier.md) -- [Out](../../../visual-basic/language-reference/modifiers/out-generic-modifier.md) +- [In](../modifiers/in-generic-modifier.md) +- [Out](../modifiers/out-generic-modifier.md) diff --git a/docs/visual-basic/language-reference/statements/while-end-while-statement.md b/docs/visual-basic/language-reference/statements/while-end-while-statement.md index 9184db22ca58a..7f8b7ef234cf4 100644 --- a/docs/visual-basic/language-reference/statements/while-end-while-statement.md +++ b/docs/visual-basic/language-reference/statements/while-end-while-statement.md @@ -36,21 +36,21 @@ End While |`End While`|Required. Terminates the definition of the `While` block.| ## Remarks - Use a `While...End While` structure when you want to repeat a set of statements an indefinite number of times, as long as a condition remains `True`. If you want more flexibility with where you test the condition or what result you test it for, you might prefer the [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md). If you want to repeat the statements a set number of times, the [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) is usually a better choice. + Use a `While...End While` structure when you want to repeat a set of statements an indefinite number of times, as long as a condition remains `True`. If you want more flexibility with where you test the condition or what result you test it for, you might prefer the [Do...Loop Statement](do-loop-statement.md). If you want to repeat the statements a set number of times, the [For...Next Statement](for-next-statement.md) is usually a better choice. > [!NOTE] -> The `While` keyword is also used in the [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md), the [Skip While Clause](../../../visual-basic/language-reference/queries/skip-while-clause.md) and the [Take While Clause](../../../visual-basic/language-reference/queries/take-while-clause.md). +> The `While` keyword is also used in the [Do...Loop Statement](do-loop-statement.md), the [Skip While Clause](../queries/skip-while-clause.md) and the [Take While Clause](../queries/take-while-clause.md). If `condition` is `True`, all of the `statements` run until the `End While` statement is encountered. Control then returns to the `While` statement, and `condition` is again checked. If `condition` is still `True`, the process is repeated. If it’s `False`, control passes to the statement that follows the `End While` statement. The `While` statement always checks the condition before it starts the loop. Looping continues while the condition remains `True`. If `condition` is `False` when you first enter the loop, it doesn’t run even once. - The `condition` usually results from a comparison of two values, but it can be any expression that evaluates to a [Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md) value (`True` or `False`). This expression can include a value of another data type, such as a numeric type, that has been converted to `Boolean`. + The `condition` usually results from a comparison of two values, but it can be any expression that evaluates to a [Boolean Data Type](../data-types/boolean-data-type.md) value (`True` or `False`). This expression can include a value of another data type, such as a numeric type, that has been converted to `Boolean`. - You can nest `While` loops by placing one loop within another. You can also nest different kinds of control structures within one another. For more information, see [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md). + You can nest `While` loops by placing one loop within another. You can also nest different kinds of control structures within one another. For more information, see [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md). ## Exit While - The [Exit While](../../../visual-basic/language-reference/statements/exit-statement.md) statement can provide another way to exit a `While` loop. `Exit While` immediately transfers control to the statement that follows the `End While` statement. + The [Exit While](exit-statement.md) statement can provide another way to exit a `While` loop. `Exit While` immediately transfers control to the statement that follows the `End While` statement. You typically use `Exit While` after some condition is evaluated (for example, in an `If...Then...Else` structure). You might want to exit a loop if you detect a condition that makes it unnecessary or impossible to continue iterating, such as an erroneous value or a termination request. You can use `Exit While` when you test for a condition that could cause an *endless loop*, which is a loop that could run an extremely large or even infinite number of times. You can then use `Exit While` to escape the loop. @@ -58,7 +58,7 @@ End While When used within nested `While` loops, `Exit While` transfers control out of the innermost loop and into the next higher level of nesting. - The `Continue While` statement immediately transfers control to the next iteration of the loop. For more information, see [Continue Statement](../../../visual-basic/language-reference/statements/continue-statement.md). + The `Continue While` statement immediately transfers control to the next iteration of the loop. For more information, see [Continue Statement](continue-statement.md). ## Example In the following example, the statements in the loop continue to run until the `index` variable is greater than 10. @@ -77,10 +77,10 @@ End While ## See also -- [Loop Structures](../../../visual-basic/programming-guide/language-features/control-flow/loop-structures.md) -- [Do...Loop Statement](../../../visual-basic/language-reference/statements/do-loop-statement.md) -- [For...Next Statement](../../../visual-basic/language-reference/statements/for-next-statement.md) -- [Boolean Data Type](../../../visual-basic/language-reference/data-types/boolean-data-type.md) -- [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md) -- [Exit Statement](../../../visual-basic/language-reference/statements/exit-statement.md) -- [Continue Statement](../../../visual-basic/language-reference/statements/continue-statement.md) +- [Loop Structures](../../programming-guide/language-features/control-flow/loop-structures.md) +- [Do...Loop Statement](do-loop-statement.md) +- [For...Next Statement](for-next-statement.md) +- [Boolean Data Type](../data-types/boolean-data-type.md) +- [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md) +- [Exit Statement](exit-statement.md) +- [Continue Statement](continue-statement.md) diff --git a/docs/visual-basic/language-reference/statements/with-end-with-statement.md b/docs/visual-basic/language-reference/statements/with-end-with-statement.md index 520352ac71b9e..e45df558e3c39 100644 --- a/docs/visual-basic/language-reference/statements/with-end-with-statement.md +++ b/docs/visual-basic/language-reference/statements/with-end-with-statement.md @@ -58,10 +58,10 @@ You can place one `With...End With` statement within another. Nested `With...End You can't branch into a `With` statement block from outside the block. -Unless the block contains a loop, the statements run only once. You can nest different kinds of control structures. For more information, see [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md). +Unless the block contains a loop, the statements run only once. You can nest different kinds of control structures. For more information, see [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md). > [!NOTE] -> You can use the `With` keyword in object initializers also. For more information and examples, see [Object Initializers: Named and Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) and [Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/anonymous-types.md). +> You can use the `With` keyword in object initializers also. For more information and examples, see [Object Initializers: Named and Anonymous Types](../../programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) and [Anonymous Types](../../programming-guide/language-features/objects-and-classes/anonymous-types.md). > > If you're using a `With` block only to initialize the properties or fields of an object that you've just instantiated, consider using an object initializer instead. @@ -80,6 +80,6 @@ The following example nests `With…End With` statements. Within the nested `Wit ## See also - -- [Nested Control Structures](../../../visual-basic/programming-guide/language-features/control-flow/nested-control-structures.md) -- [Object Initializers: Named and Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) -- [Anonymous Types](../../../visual-basic/programming-guide/language-features/objects-and-classes/anonymous-types.md) +- [Nested Control Structures](../../programming-guide/language-features/control-flow/nested-control-structures.md) +- [Object Initializers: Named and Anonymous Types](../../programming-guide/language-features/objects-and-classes/object-initializers-named-and-anonymous-types.md) +- [Anonymous Types](../../programming-guide/language-features/objects-and-classes/anonymous-types.md) diff --git a/docs/visual-basic/language-reference/statements/yield-statement.md b/docs/visual-basic/language-reference/statements/yield-statement.md index ff1814843a8ca..d1f857d12e01b 100644 --- a/docs/visual-basic/language-reference/statements/yield-statement.md +++ b/docs/visual-basic/language-reference/statements/yield-statement.md @@ -27,7 +27,7 @@ Yield expression ## Remarks The `Yield` statement returns one element of a collection at a time. The `Yield` statement is included in an iterator function or `Get` accessor, which perform custom iterations over a collection. - You consume an iterator function by using a [For Each...Next Statement](../../../visual-basic/language-reference/statements/for-each-next-statement.md) or a LINQ query. Each iteration of the `For Each` loop calls the iterator function. When a `Yield` statement is reached in the iterator function, `expression` is returned, and the current location in code is retained. Execution is restarted from that location the next time that the iterator function is called. + You consume an iterator function by using a [For Each...Next Statement](for-each-next-statement.md) or a LINQ query. Each iteration of the `For Each` loop calls the iterator function. When a `Yield` statement is reached in the iterator function, `expression` is returned, and the current location in code is retained. Execution is restarted from that location the next time that the iterator function is called. An implicit conversion must exist from the type of `expression` in the `Yield` statement to the return type of the iterator. @@ -40,7 +40,7 @@ Yield expression ## Iterator Functions and Get Accessors The declaration of an iterator function or `Get` accessor must meet the following requirements: -- It must include an [Iterator](../../../visual-basic/language-reference/modifiers/iterator.md) modifier. +- It must include an [Iterator](../modifiers/iterator.md) modifier. - The return type must be , , , or . @@ -51,7 +51,7 @@ Yield expression An iterator function can be an anonymous function. For more information, see [Iterators](../../programming-guide/concepts/iterators.md). ## Exception Handling - A `Yield` statement can be inside a `Try` block of a [Try...Catch...Finally Statement](../../../visual-basic/language-reference/statements/try-catch-finally-statement.md). A `Try` block that has a `Yield` statement can have `Catch` blocks, and can have a `Finally` block. + A `Yield` statement can be inside a `Try` block of a [Try...Catch...Finally Statement](try-catch-finally-statement.md). A `Try` block that has a `Yield` statement can have `Catch` blocks, and can have a `Finally` block. A `Yield` statement cannot be inside a `Catch` block or a `Finally` block. @@ -74,7 +74,7 @@ Next On each subsequent iteration of the `For Each` loop, the execution of the iterator body continues from where it left off, again stopping when it reaches a `Yield` statement. The `For Each` loop completes when the end of the iterator function or a `Return` or `Exit Function` statement is reached. ## Example - The following example has a `Yield` statement that is inside a [For…Next](../../../visual-basic/language-reference/statements/for-next-statement.md) loop. Each iteration of the [For Each](../../../visual-basic/language-reference/statements/for-each-next-statement.md) statement body in `Main` creates a call to the `Power` iterator function. Each call to the iterator function proceeds to the next execution of the `Yield` statement, which occurs during the next iteration of the `For…Next` loop. + The following example has a `Yield` statement that is inside a [For…Next](for-next-statement.md) loop. Each iteration of the [For Each](for-each-next-statement.md) statement body in `Main` creates a call to the `Power` iterator function. Each call to the iterator function proceeds to the next execution of the `Yield` statement, which occurs during the next iteration of the `For…Next` loop. The return type of the iterator method is , an iterator interface type. When the iterator method is called, it returns an enumerable object that contains the powers of a number. @@ -89,4 +89,4 @@ Next ## See also -- [Statements](../../../visual-basic/language-reference/statements/index.md) +- [Statements](index.md) diff --git a/docs/visual-basic/language-reference/typographic-and-code-conventions.md b/docs/visual-basic/language-reference/typographic-and-code-conventions.md index e26e3e6804c27..10fc3d1706404 100644 --- a/docs/visual-basic/language-reference/typographic-and-code-conventions.md +++ b/docs/visual-basic/language-reference/typographic-and-code-conventions.md @@ -21,7 +21,7 @@ Visual Basic documentation uses the following typographic and code conventions. |-------------|-----------------| |`Sub`, `If`, `ChDir`, `Print`, `True`, `Debug`|Language-specific keywords and runtime members have initial uppercase letters and are formatted as shown in this example.| |**SmallProject**, **ButtonCollection**|Words and phrases you are instructed to type are formatted as shown in this example.| -|[Module Statement](../../visual-basic/language-reference/statements/module-statement.md)|Links you can click to go to another Help page are formatted as shown in this example.| +|[Module Statement](statements/module-statement.md)|Links you can click to go to another Help page are formatted as shown in this example.| |*object*, *variableName*, `argumentList`|Placeholders for information that you supply are formatted as shown in this example.| |[ Shadows ], [ *expressionList* ]|In syntax, optional items are enclosed in brackets.| |{ `Public` | `Friend` | `Private` }|In syntax, when you must make a choice between two or more items, the items are enclosed in braces and separated by vertical bars.

You must select one, and only one, of the items.| @@ -43,9 +43,9 @@ Visual Basic documentation uses the following typographic and code conventions. ## See also -- [Visual Basic Language Reference](../../visual-basic/language-reference/index.md) -- [Keywords](../../visual-basic/language-reference/keywords/index.md) -- [Visual Basic Runtime Library Members](../../visual-basic/language-reference/runtime-library-members.md) -- [Visual Basic Naming Conventions](../../visual-basic/programming-guide/program-structure/naming-conventions.md) -- [How to: Break and Combine Statements in Code](../../visual-basic/programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) -- [Comments in Code](../../visual-basic/programming-guide/program-structure/comments-in-code.md) +- [Visual Basic Language Reference](index.md) +- [Keywords](keywords/index.md) +- [Visual Basic Runtime Library Members](runtime-library-members.md) +- [Visual Basic Naming Conventions](../programming-guide/program-structure/naming-conventions.md) +- [How to: Break and Combine Statements in Code](../programming-guide/program-structure/how-to-break-and-combine-statements-in-code.md) +- [Comments in Code](../programming-guide/program-structure/comments-in-code.md) diff --git a/docs/visual-basic/language-reference/xml-axis/extension-indexer-property.md b/docs/visual-basic/language-reference/xml-axis/extension-indexer-property.md index 598fbe7921a63..df30a76a79d6e 100644 --- a/docs/visual-basic/language-reference/xml-axis/extension-indexer-property.md +++ b/docs/visual-basic/language-reference/xml-axis/extension-indexer-property.md @@ -38,7 +38,7 @@ object(index) This indexer property is like an extension property for collections that implement or : it is used only if the collection does not have an indexer or a default property. - To access the value of the first element in a collection of or objects, you can use the XML `Value` property. For more information, see [XML Value Property](../../../visual-basic/language-reference/xml-axis/xml-value-property.md). + To access the value of the first element in a collection of or objects, you can use the XML `Value` property. For more information, see [XML Value Property](xml-value-property.md). ## Example The following example shows how to use the extension indexer to access the second child node in a collection of objects. The collection is accessed by using the child axis property, which gets all child elements named `phone` in the `contact` object. @@ -52,7 +52,7 @@ object(index) ## See also - -- [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) -- [XML Value Property](../../../visual-basic/language-reference/xml-axis/xml-value-property.md) +- [XML Axis Properties](index.md) +- [XML Literals](../xml-literals/index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) +- [XML Value Property](xml-value-property.md) diff --git a/docs/visual-basic/language-reference/xml-axis/index.md b/docs/visual-basic/language-reference/xml-axis/index.md index 203d8c53e5238..4a724d04f522f 100644 --- a/docs/visual-basic/language-reference/xml-axis/index.md +++ b/docs/visual-basic/language-reference/xml-axis/index.md @@ -15,12 +15,12 @@ The topics in this section document the syntax of XML axis properties in Visual |Topic|Description| |-----------|-----------------| -|[XML Attribute Axis Property](../../../visual-basic/language-reference/xml-axis/xml-attribute-axis-property.md)|Describes how to access the attributes of an object.| -|[XML Child Axis Property](../../../visual-basic/language-reference/xml-axis/xml-child-axis-property.md)|Describes how to access the children of an object.| -|[XML Descendant Axis Property](../../../visual-basic/language-reference/xml-axis/xml-descendant-axis-property.md)|Describes how to access the descendants of an object.| -|[Extension Indexer Property](../../../visual-basic/language-reference/xml-axis/extension-indexer-property.md)|Describes how to access individual elements in a collection of or objects.| -|[XML Value Property](../../../visual-basic/language-reference/xml-axis/xml-value-property.md)|Describes how to access the value of the first element of a collection of or objects.| +|[XML Attribute Axis Property](xml-attribute-axis-property.md)|Describes how to access the attributes of an object.| +|[XML Child Axis Property](xml-child-axis-property.md)|Describes how to access the children of an object.| +|[XML Descendant Axis Property](xml-descendant-axis-property.md)|Describes how to access the descendants of an object.| +|[Extension Indexer Property](extension-indexer-property.md)|Describes how to access individual elements in a collection of or objects.| +|[XML Value Property](xml-value-property.md)|Describes how to access the value of the first element of a collection of or objects.| ## See also -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/xml-axis/xml-attribute-axis-property.md b/docs/visual-basic/language-reference/xml-axis/xml-attribute-axis-property.md index 3b40d433dabb7..3bfe63ba975c6 100644 --- a/docs/visual-basic/language-reference/xml-axis/xml-attribute-axis-property.md +++ b/docs/visual-basic/language-reference/xml-axis/xml-attribute-axis-property.md @@ -38,7 +38,7 @@ object.@ |Part|Description| |----------|-----------------| |`prefix`|Optional. XML namespace prefix for the attribute. Must be a global XML namespace defined with an `Imports` statement.| -|`name`|Required. Local attribute name. See [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).| +|`name`|Required. Local attribute name. See [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).| \> Optional. Denotes the end of the name of the attribute when `attribute` is not a valid identifier in Visual Basic. @@ -54,7 +54,7 @@ object.@ The naming rules for XML attributes differ from the naming rules for Visual Basic identifiers. To access an XML attribute that has a name that is not a valid Visual Basic identifier, enclose the name in angle brackets (\< and >). ## XML Namespaces - The name in an attribute axis property can use only XML namespace prefixes declared globally by using the `Imports` statement. It cannot use XML namespace prefixes declared locally within XML element literals. For more information, see [Imports Statement (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md). + The name in an attribute axis property can use only XML namespace prefixes declared globally by using the `Imports` statement. It cannot use XML namespace prefixes declared locally within XML element literals. For more information, see [Imports Statement (XML Namespace)](../statements/imports-statement-xml-namespace.md). ## Example The following example shows how to get the values of the XML attributes named `type` from a collection of XML elements that are named `phone`. @@ -103,7 +103,7 @@ object.@ ## See also - -- [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) -- [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) +- [XML Axis Properties](index.md) +- [XML Literals](../xml-literals/index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) +- [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) diff --git a/docs/visual-basic/language-reference/xml-axis/xml-child-axis-property.md b/docs/visual-basic/language-reference/xml-axis/xml-child-axis-property.md index 31eaa71150611..0e703773ea03c 100644 --- a/docs/visual-basic/language-reference/xml-axis/xml-child-axis-property.md +++ b/docs/visual-basic/language-reference/xml-axis/xml-child-axis-property.md @@ -26,19 +26,19 @@ object. |---|---| |`object`|Required. An object, an object, a collection of objects, or a collection of objects.| |.<|Required. Denotes the start of a child axis property.| -|`child`|Required. Name of the child nodes to access, of the form `[prefix:]name`.

- `Prefix` - Optional. XML namespace prefix for the child node. Must be a global XML namespace defined with an `Imports` statement.
- `Name` - Required. Local child node name. See [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).| +|`child`|Required. Name of the child nodes to access, of the form `[prefix:]name`.

- `Prefix` - Optional. XML namespace prefix for the child node. Must be a global XML namespace defined with an `Imports` statement.
- `Name` - Required. Local child node name. See [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).| |>|Required. Denotes the end of a child axis property.| ## Return Value A collection of objects. ## Remarks - You can use an XML child axis property to access child nodes by name from an or object, or from a collection of or objects. Use the XML `Value` property to access the value of the first child node in the returned collection. For more information, see [XML Value Property](../../../visual-basic/language-reference/xml-axis/xml-value-property.md). + You can use an XML child axis property to access child nodes by name from an or object, or from a collection of or objects. Use the XML `Value` property to access the value of the first child node in the returned collection. For more information, see [XML Value Property](xml-value-property.md). The Visual Basic compiler converts child axis properties to calls to the method. ## XML Namespaces - The name in a child axis property can use only XML namespace prefixes declared globally with the `Imports` statement. It cannot use XML namespace prefixes declared locally within XML element literals. For more information, see [Imports Statement (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md). + The name in a child axis property can use only XML namespace prefixes declared globally with the `Imports` statement. It cannot use XML namespace prefixes declared locally within XML element literals. For more information, see [Imports Statement (XML Namespace)](../statements/imports-statement-xml-namespace.md). ## Example The following example shows how to access the child nodes named `phone` from the `contact` object. @@ -70,7 +70,7 @@ object. ## See also - -- [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) -- [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) +- [XML Axis Properties](index.md) +- [XML Literals](../xml-literals/index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) +- [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) diff --git a/docs/visual-basic/language-reference/xml-axis/xml-descendant-axis-property.md b/docs/visual-basic/language-reference/xml-axis/xml-descendant-axis-property.md index 0c99dd3b6071f..17f1abd0d5e56 100644 --- a/docs/visual-basic/language-reference/xml-axis/xml-descendant-axis-property.md +++ b/docs/visual-basic/language-reference/xml-axis/xml-descendant-axis-property.md @@ -36,7 +36,7 @@ Required. Name of the descendant nodes to access, of the form [`prefix:]name`. |Part|Description| |----------|-----------------| |`prefix`|Optional. XML namespace prefix for the descendant node. Must be a global XML namespace that is defined by using an `Imports` statement.| -|`name`|Required. Local name of the descendant node. See [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).| +|`name`|Required. Local name of the descendant node. See [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).| `>` Required. Denotes the end of a descendant axis property. @@ -47,13 +47,13 @@ A collection of objects. ## Remarks -You can use an XML descendant axis property to access descendant nodes by name from an or object, or from a collection of or objects. Use the XML `Value` property to access the value of the first descendant node in the returned collection. For more information, see [XML Value Property](../../../visual-basic/language-reference/xml-axis/xml-value-property.md). +You can use an XML descendant axis property to access descendant nodes by name from an or object, or from a collection of or objects. Use the XML `Value` property to access the value of the first descendant node in the returned collection. For more information, see [XML Value Property](xml-value-property.md). The Visual Basic compiler converts descendant axis properties into calls to the method. ## XML Namespaces -The name in a descendant axis property can use only XML namespaces declared globally with the `Imports` statement. It cannot use XML namespaces declared locally within XML element literals. For more information, see [Imports Statement (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md). +The name in a descendant axis property can use only XML namespaces declared globally with the `Imports` statement. It cannot use XML namespaces declared locally within XML element literals. For more information, see [Imports Statement (XML Namespace)](../statements/imports-statement-xml-namespace.md). ## Example @@ -80,7 +80,7 @@ This code displays the following text: ## See also - -- [XML Axis Properties](../../../visual-basic/language-reference/xml-axis/index.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) -- [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) +- [XML Axis Properties](index.md) +- [XML Literals](../xml-literals/index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) +- [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) diff --git a/docs/visual-basic/language-reference/xml-literals/index.md b/docs/visual-basic/language-reference/xml-literals/index.md index f852676ba6bae..ab15af4b59129 100644 --- a/docs/visual-basic/language-reference/xml-literals/index.md +++ b/docs/visual-basic/language-reference/xml-literals/index.md @@ -17,12 +17,12 @@ The topics in this section document the syntax of XML literals in Visual Basic. |Topic|Description| |-----------|-----------------| -|[XML Element Literal](../../../visual-basic/language-reference/xml-literals/xml-element-literal.md)|Describes the syntax for literals that represent objects.| -|[XML Document Literal](../../../visual-basic/language-reference/xml-literals/xml-document-literal.md)|Describes the syntax for literals that represent objects.| -|[XML CDATA Literal](../../../visual-basic/language-reference/xml-literals/xml-cdata-literal.md)|Describes the syntax for literals that represent objects.| -|[XML Comment Literal](../../../visual-basic/language-reference/xml-literals/xml-comment-literal.md)|Describes the syntax for literals that represent objects.| -|[XML Processing Instruction Literal](../../../visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md)|Describes the syntax for literals that represent objects.| +|[XML Element Literal](xml-element-literal.md)|Describes the syntax for literals that represent objects.| +|[XML Document Literal](xml-document-literal.md)|Describes the syntax for literals that represent objects.| +|[XML CDATA Literal](xml-cdata-literal.md)|Describes the syntax for literals that represent objects.| +|[XML Comment Literal](xml-comment-literal.md)|Describes the syntax for literals that represent objects.| +|[XML Processing Instruction Literal](xml-processing-instruction-literal.md)|Describes the syntax for literals that represent objects.| ## See also -- [XML](../../../visual-basic/programming-guide/language-features/xml/index.md) +- [XML](../../programming-guide/language-features/xml/index.md) diff --git a/docs/visual-basic/language-reference/xml-literals/xml-cdata-literal.md b/docs/visual-basic/language-reference/xml-literals/xml-cdata-literal.md index 5a94c3b690e52..6df100b7706bb 100644 --- a/docs/visual-basic/language-reference/xml-literals/xml-cdata-literal.md +++ b/docs/visual-basic/language-reference/xml-literals/xml-cdata-literal.md @@ -53,6 +53,6 @@ A literal representing an object. ## See also - -- [XML Element Literal](../../../visual-basic/language-reference/xml-literals/xml-element-literal.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) +- [XML Element Literal](xml-element-literal.md) +- [XML Literals](index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) diff --git a/docs/visual-basic/language-reference/xml-literals/xml-comment-literal.md b/docs/visual-basic/language-reference/xml-literals/xml-comment-literal.md index e62b6af786a27..014ff985fae4f 100644 --- a/docs/visual-basic/language-reference/xml-literals/xml-comment-literal.md +++ b/docs/visual-basic/language-reference/xml-literals/xml-comment-literal.md @@ -52,6 +52,6 @@ A literal representing an object. ## See also - -- [XML Element Literal](../../../visual-basic/language-reference/xml-literals/xml-element-literal.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) +- [XML Element Literal](xml-element-literal.md) +- [XML Literals](index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) diff --git a/docs/visual-basic/language-reference/xml-literals/xml-document-literal.md b/docs/visual-basic/language-reference/xml-literals/xml-document-literal.md index b431c19c96a21..5522dacd6f4f8 100644 --- a/docs/visual-basic/language-reference/xml-literals/xml-document-literal.md +++ b/docs/visual-basic/language-reference/xml-literals/xml-document-literal.md @@ -28,8 +28,8 @@ rootElement |---|---| |`encoding`|Optional. Literal text declaring which encoding the document uses.| |`standalone`|Optional. Literal text. Must be "yes" or "no".| -|`piCommentList`|Optional. List of XML processing instructions and XML comments. Takes the following format:

`piComment [` `piComment` `... ]`

Each `piComment` can be one of the following:

- [XML Processing Instruction Literal](../../../visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md).
- [XML Comment Literal](../../../visual-basic/language-reference/xml-literals/xml-comment-literal.md).| -|`rootElement`|Required. Root element of the document. The format is one of the following:

  • [XML Element Literal](../../../visual-basic/language-reference/xml-literals/xml-element-literal.md).
  • Embedded expression of the form `<%=` `elementExp` `%>`. The `elementExp` returns one of the following:

    • An object.
    • A collection that contains one object and any number of and objects.

For more information, see [Embedded Expressions in XML](../../../visual-basic/programming-guide/language-features/xml/embedded-expressions-in-xml.md).| +|`piCommentList`|Optional. List of XML processing instructions and XML comments. Takes the following format:

`piComment [` `piComment` `... ]`

Each `piComment` can be one of the following:

- [XML Processing Instruction Literal](xml-processing-instruction-literal.md).
- [XML Comment Literal](xml-comment-literal.md).| +|`rootElement`|Required. Root element of the document. The format is one of the following:

  • [XML Element Literal](xml-element-literal.md).
  • Embedded expression of the form `<%=` `elementExp` `%>`. The `elementExp` returns one of the following:

    • An object.
    • A collection that contains one object and any number of and objects.

For more information, see [Embedded Expressions in XML](../../programming-guide/language-features/xml/embedded-expressions-in-xml.md).| ## Return Value An object. @@ -55,9 +55,9 @@ rootElement - - - -- [XML Processing Instruction Literal](../../../visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md) -- [XML Comment Literal](../../../visual-basic/language-reference/xml-literals/xml-comment-literal.md) -- [XML Element Literal](../../../visual-basic/language-reference/xml-literals/xml-element-literal.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) -- [Embedded Expressions in XML](../../../visual-basic/programming-guide/language-features/xml/embedded-expressions-in-xml.md) +- [XML Processing Instruction Literal](xml-processing-instruction-literal.md) +- [XML Comment Literal](xml-comment-literal.md) +- [XML Element Literal](xml-element-literal.md) +- [XML Literals](index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) +- [Embedded Expressions in XML](../../programming-guide/language-features/xml/embedded-expressions-in-xml.md) diff --git a/docs/visual-basic/language-reference/xml-literals/xml-element-literal.md b/docs/visual-basic/language-reference/xml-literals/xml-element-literal.md index 2241ca229382a..f11d6a90a0509 100644 --- a/docs/visual-basic/language-reference/xml-literals/xml-element-literal.md +++ b/docs/visual-basic/language-reference/xml-literals/xml-element-literal.md @@ -36,7 +36,7 @@ A literal that represents an object. |Part|Description| |---|---| |`ePrefix`|Optional. XML namespace prefix for the element. Must be a global XML namespace that is defined with an `Imports` statement in the file or at the project level, or a local XML namespace that is defined in this element or a parent element.| - |`eName`|Required. Name of the element. The format is one of the following:

- Literal text. See [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).
- Embedded expression of the form `<%= eNameExp %>`. The type of `eNameExp` must be `String` or a type that is implicitly convertible to .| + |`eName`|Required. Name of the element. The format is one of the following:

- Literal text. See [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).
- Embedded expression of the form `<%= eNameExp %>`. The type of `eNameExp` must be `String` or a type that is implicitly convertible to .| - Embedded expression of the form `<%= nameExp %>`. The type of `nameExp` must be `String` or a type implicitly convertible to . An embedded expression is not allowed in a closing tag of an element. @@ -53,7 +53,7 @@ A literal that represents an object. |Part|Description| |---|---| |`aPrefix`|Optional. XML namespace prefix for the attribute. Must be a global XML namespace that is defined with an `Imports` statement, or a local XML namespace that is defined in this element or a parent element.| - |`aName`|Required. Name of the attribute. The format is one of the following:

- Literal text. See [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).
- Embedded expression of the form `<%= aNameExp %>`. The type of `aNameExp` must be `String` or a type that is implicitly convertible to .| + |`aName`|Required. Name of the attribute. The format is one of the following:

- Literal text. See [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md).
- Embedded expression of the form `<%= aNameExp %>`. The type of `aNameExp` must be `String` or a type that is implicitly convertible to .| |`aValue`|Optional. Value of the attribute. The format is one of the following:

- Literal text, enclosed in quotation marks.
- Embedded expression of the form `<%= aValueExp %>`. Any type is allowed.| - Embedded expression of the form `<%= aExp %>`. @@ -80,11 +80,11 @@ A literal that represents an object. - XML element literal. - - XML comment literal. See [XML Comment Literal](../../../visual-basic/language-reference/xml-literals/xml-comment-literal.md). + - XML comment literal. See [XML Comment Literal](xml-comment-literal.md). - - XML processing instruction literal. See [XML Processing Instruction Literal](../../../visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md). + - XML processing instruction literal. See [XML Processing Instruction Literal](xml-processing-instruction-literal.md). - - XML CDATA literal. See [XML CDATA Literal](../../../visual-basic/language-reference/xml-literals/xml-cdata-literal.md). + - XML CDATA literal. See [XML CDATA Literal](xml-cdata-literal.md). - `` @@ -101,13 +101,13 @@ You can use the XML element literal syntax to create [!NOTE] > An XML literal can span multiple lines without using line continuation characters. This feature enables you to copy content from an XML document and paste it directly into a Visual Basic program. -Embedded expressions of the form `<%= exp %>` enable you to add dynamic information to an XML element literal. For more information, see [Embedded Expressions in XML](../../../visual-basic/programming-guide/language-features/xml/embedded-expressions-in-xml.md). +Embedded expressions of the form `<%= exp %>` enable you to add dynamic information to an XML element literal. For more information, see [Embedded Expressions in XML](../../programming-guide/language-features/xml/embedded-expressions-in-xml.md). The Visual Basic compiler converts the XML element literal into calls to the constructor and, if it is required, the constructor. ## XML Namespaces -XML namespace prefixes are useful when you have to create XML literals with elements from the same namespace many times in code. You can use global XML namespace prefixes, which you define by using the `Imports` statement, or local prefixes, which you define by using the `xmlns:xmlPrefix="xmlNamespace"` attribute syntax. For more information, see [Imports Statement (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md). +XML namespace prefixes are useful when you have to create XML literals with elements from the same namespace many times in code. You can use global XML namespace prefixes, which you define by using the `Imports` statement, or local prefixes, which you define by using the `xmlns:xmlPrefix="xmlNamespace"` attribute syntax. For more information, see [Imports Statement (XML Namespace)](../statements/imports-statement-xml-namespace.md). In accordance with the scoping rules for XML namespaces, local prefixes take precedence over global prefixes. However, if an XML literal defines an XML namespace, that namespace is not available to expressions that appear in an embedded expression. The embedded expression can access only the global XML namespace. @@ -162,10 +162,10 @@ Notice that the compiler converted the prefix of the global XML namespace into a ## See also - -- [Names of Declared XML Elements and Attributes](../../../visual-basic/programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) -- [XML Comment Literal](../../../visual-basic/language-reference/xml-literals/xml-comment-literal.md) -- [XML CDATA Literal](../../../visual-basic/language-reference/xml-literals/xml-cdata-literal.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) -- [Embedded Expressions in XML](../../../visual-basic/programming-guide/language-features/xml/embedded-expressions-in-xml.md) -- [Imports Statement (XML Namespace)](../../../visual-basic/language-reference/statements/imports-statement-xml-namespace.md) +- [Names of Declared XML Elements and Attributes](../../programming-guide/language-features/xml/names-of-declared-xml-elements-and-attributes.md) +- [XML Comment Literal](xml-comment-literal.md) +- [XML CDATA Literal](xml-cdata-literal.md) +- [XML Literals](index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) +- [Embedded Expressions in XML](../../programming-guide/language-features/xml/embedded-expressions-in-xml.md) +- [Imports Statement (XML Namespace)](../statements/imports-statement-xml-namespace.md) diff --git a/docs/visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md b/docs/visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md index 950eaef961385..3d3c315636923 100644 --- a/docs/visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md +++ b/docs/visual-basic/language-reference/xml-literals/xml-processing-instruction-literal.md @@ -37,7 +37,7 @@ A literal representing an object. ## Remarks XML processing instruction literals indicate how applications should process an XML document. When an application loads an XML document, the application can check the XML processing instructions to determine how to process the document. The application interprets the meaning of `piName` and `piData`. - The XML document literal uses syntax that is similar to that of the XML processing instruction. For more information, see [XML Document Literal](../../../visual-basic/language-reference/xml-literals/xml-document-literal.md). + The XML document literal uses syntax that is similar to that of the XML processing instruction. For more information, see [XML Document Literal](xml-document-literal.md). > [!NOTE] > The `piName` element cannot begin with the strings "xml" or "XML", because the XML 1.0 specification reserves those identifiers. @@ -57,6 +57,6 @@ A literal representing an object. ## See also - -- [XML Document Literal](../../../visual-basic/language-reference/xml-literals/xml-document-literal.md) -- [XML Literals](../../../visual-basic/language-reference/xml-literals/index.md) -- [Creating XML in Visual Basic](../../../visual-basic/programming-guide/language-features/xml/creating-xml.md) +- [XML Document Literal](xml-document-literal.md) +- [XML Literals](index.md) +- [Creating XML in Visual Basic](../../programming-guide/language-features/xml/creating-xml.md) diff --git a/docs/visual-basic/language-reference/xmldoc/c.md b/docs/visual-basic/language-reference/xmldoc/c.md index 20b140cb5fff3..6edb7baf0b944 100644 --- a/docs/visual-basic/language-reference/xmldoc/c.md +++ b/docs/visual-basic/language-reference/xmldoc/c.md @@ -22,9 +22,9 @@ Indicates that text within a description is code. |`text`|The text you would like to indicate as code.| ## Remarks - The `` tag gives you a way to indicate that text within a description should be marked as code. Use [\](../../../visual-basic/language-reference/xmldoc/code.md) to indicate multiple lines as code. + The `` tag gives you a way to indicate that text within a description should be marked as code. Use [\](code.md) to indicate multiple lines as code. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag in the summary section to indicate that `Counter` is code. @@ -33,4 +33,4 @@ Indicates that text within a description is code. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/code.md b/docs/visual-basic/language-reference/xmldoc/code.md index efd3ca7462713..f6fd8b3026bca 100644 --- a/docs/visual-basic/language-reference/xmldoc/code.md +++ b/docs/visual-basic/language-reference/xmldoc/code.md @@ -20,9 +20,9 @@ Indicates that the text is multiple lines of code. The text to mark as code. ## Remarks - Use the `` tag to indicate multiple lines as code. Use [\](../../../visual-basic/language-reference/xmldoc/c.md) to indicate that text within a description should be marked as code. + Use the `` tag to indicate multiple lines as code. Use [\](c.md) to indicate that text within a description should be marked as code. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the \ tag to include example code for using the `ID` field. @@ -31,4 +31,4 @@ Indicates that the text is multiple lines of code. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/example.md b/docs/visual-basic/language-reference/xmldoc/example.md index bf8d8a325b03d..bfc740c7dc7d6 100644 --- a/docs/visual-basic/language-reference/xmldoc/example.md +++ b/docs/visual-basic/language-reference/xmldoc/example.md @@ -20,9 +20,9 @@ Specifies an example for the member. A description of the code sample. ## Remarks - The `` tag lets you specify an example of how to use a method or other library member. This commonly involves using the [\](../../../visual-basic/language-reference/xmldoc/code.md) tag. + The `` tag lets you specify an example of how to use a method or other library member. This commonly involves using the [\](code.md) tag. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to include an example for using the `ID` field. @@ -31,4 +31,4 @@ Specifies an example for the member. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/exception.md b/docs/visual-basic/language-reference/xmldoc/exception.md index 52fc9603737f4..9d53e78a799e3 100644 --- a/docs/visual-basic/language-reference/xmldoc/exception.md +++ b/docs/visual-basic/language-reference/xmldoc/exception.md @@ -25,7 +25,7 @@ Specifies which exceptions can be thrown. ## Remarks Use the `` tag to specify which exceptions can be thrown. This tag is applied to a method definition. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to describe an exception that the `IntDivide` function can throw. @@ -34,4 +34,4 @@ Specifies which exceptions can be thrown. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/include.md b/docs/visual-basic/language-reference/xmldoc/include.md index a1b3ee3379eaf..c70bcba13b391 100644 --- a/docs/visual-basic/language-reference/xmldoc/include.md +++ b/docs/visual-basic/language-reference/xmldoc/include.md @@ -55,4 +55,4 @@ Refers to another file that describes the types and members in your source code. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/index.md b/docs/visual-basic/language-reference/xmldoc/index.md index b3043cd293367..829ad8b2f06c7 100644 --- a/docs/visual-basic/language-reference/xmldoc/index.md +++ b/docs/visual-basic/language-reference/xmldoc/index.md @@ -21,12 +21,12 @@ The Visual Basic compiler can process documentation comments in your code to an |||| |---|---|---| -|[\](../../../visual-basic/language-reference/xmldoc/c.md)|[\](../../../visual-basic/language-reference/xmldoc/code.md)|[\](../../../visual-basic/language-reference/xmldoc/example.md)| -|[\](../../../visual-basic/language-reference/xmldoc/exception.md) 1|[\](../../../visual-basic/language-reference/xmldoc/include.md) 1|[\](../../../visual-basic/language-reference/xmldoc/list.md)| -|[\](../../../visual-basic/language-reference/xmldoc/para.md)|[\](../../../visual-basic/language-reference/xmldoc/param.md) 1|[\](../../../visual-basic/language-reference/xmldoc/paramref.md)| -|[\](../../../visual-basic/language-reference/xmldoc/permission.md) 1|[\](../../../visual-basic/language-reference/xmldoc/remarks.md)|[\](../../../visual-basic/language-reference/xmldoc/returns.md)| -|[\](../../../visual-basic/language-reference/xmldoc/see.md) 1|[\](../../../visual-basic/language-reference/xmldoc/seealso.md) 1|[\](../../../visual-basic/language-reference/xmldoc/summary.md)| -|[\](../../../visual-basic/language-reference/xmldoc/typeparam.md) 1|[\](../../../visual-basic/language-reference/xmldoc/value.md)|| +|[\](c.md)|[\](code.md)|[\](example.md)| +|[\](exception.md) 1|[\](include.md) 1|[\](list.md)| +|[\](para.md)|[\](param.md) 1|[\](paramref.md)| +|[\](permission.md) 1|[\](remarks.md)|[\](returns.md)| +|[\](see.md) 1|[\](seealso.md) 1|[\](summary.md)| +|[\](typeparam.md) 1|[\](value.md)|| (1 The compiler verifies syntax.) @@ -35,6 +35,6 @@ The Visual Basic compiler can process documentation comments in your code to an ## See also -- [Documenting Your Code with XML](../../../visual-basic/programming-guide/program-structure/documenting-your-code-with-xml.md) -- [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) -- [How to: Create XML Documentation](../../../visual-basic/programming-guide/program-structure/how-to-create-xml-documentation.md) +- [Documenting Your Code with XML](../../programming-guide/program-structure/documenting-your-code-with-xml.md) +- [-doc](../../reference/command-line-compiler/doc.md) +- [How to: Create XML Documentation](../../programming-guide/program-structure/how-to-create-xml-documentation.md) diff --git a/docs/visual-basic/language-reference/xmldoc/list.md b/docs/visual-basic/language-reference/xmldoc/list.md index 7d2fa30c4f7f6..754c65c7015c6 100644 --- a/docs/visual-basic/language-reference/xmldoc/list.md +++ b/docs/visual-basic/language-reference/xmldoc/list.md @@ -49,7 +49,7 @@ Defines a list or table. A list or table can have as many `` blocks as needed. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to define a bulleted list in the remarks section. @@ -58,4 +58,4 @@ Defines a list or table. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/para.md b/docs/visual-basic/language-reference/xmldoc/para.md index cce76f39f6725..b6be6c9d4a1a2 100644 --- a/docs/visual-basic/language-reference/xmldoc/para.md +++ b/docs/visual-basic/language-reference/xmldoc/para.md @@ -20,9 +20,9 @@ Specifies that the content is formatted as a paragraph. The text of the paragraph. ## Remarks - The `` tag is for use inside a tag, such as [\](../../../visual-basic/language-reference/xmldoc/summary.md), [\](../../../visual-basic/language-reference/xmldoc/remarks.md), or [\](../../../visual-basic/language-reference/xmldoc/returns.md), and lets you add structure to the text. + The `` tag is for use inside a tag, such as [\](summary.md), [\](remarks.md), or [\](returns.md), and lets you add structure to the text. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to split the remarks section for the `UpdateRecord` method into two paragraphs. @@ -31,4 +31,4 @@ Specifies that the content is formatted as a paragraph. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/param.md b/docs/visual-basic/language-reference/xmldoc/param.md index 4cb26176f04da..c6c10a1be3fc7 100644 --- a/docs/visual-basic/language-reference/xmldoc/param.md +++ b/docs/visual-basic/language-reference/xmldoc/param.md @@ -31,7 +31,7 @@ Defines a parameter name and description. - Object Browser. For more information, see [Viewing the Structure of Code](/visualstudio/ide/viewing-the-structure-of-code). - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to describe the `id` parameter. @@ -40,4 +40,4 @@ Defines a parameter name and description. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/paramref.md b/docs/visual-basic/language-reference/xmldoc/paramref.md index 7c46ba5125bbd..8f1318509d0b3 100644 --- a/docs/visual-basic/language-reference/xmldoc/paramref.md +++ b/docs/visual-basic/language-reference/xmldoc/paramref.md @@ -22,7 +22,7 @@ Formats a word as a parameter. ## Remarks The `` tag gives you a way to indicate that a word is a parameter. The XML file can be processed to format this parameter in some distinct way. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to refer to the `id` parameter. @@ -31,4 +31,4 @@ Formats a word as a parameter. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/permission.md b/docs/visual-basic/language-reference/xmldoc/permission.md index 5b16e78fbb437..3bb35fd6b7136 100644 --- a/docs/visual-basic/language-reference/xmldoc/permission.md +++ b/docs/visual-basic/language-reference/xmldoc/permission.md @@ -25,7 +25,7 @@ Specifies a required permission for the member. ## Remarks Use the `` tag to document the access of a member. Use the class to specify access to a member. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to describe that the is required by the `ReadFile` method. @@ -34,4 +34,4 @@ Specifies a required permission for the member. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/remarks.md b/docs/visual-basic/language-reference/xmldoc/remarks.md index dc5f7e30599b3..8950e4438d734 100644 --- a/docs/visual-basic/language-reference/xmldoc/remarks.md +++ b/docs/visual-basic/language-reference/xmldoc/remarks.md @@ -20,11 +20,11 @@ Specifies a remarks section for the member. A description of the member. ## Remarks - Use the `` tag to add information about a type, supplementing the information specified with [\](../../../visual-basic/language-reference/xmldoc/summary.md). + Use the `` tag to add information about a type, supplementing the information specified with [\](summary.md). This information appears in the Object Browser. For information about the Object Browser, see [Viewing the Structure of Code](/visualstudio/ide/viewing-the-structure-of-code). - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to explain what the `UpdateRecord` method does. @@ -33,4 +33,4 @@ Specifies a remarks section for the member. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/returns.md b/docs/visual-basic/language-reference/xmldoc/returns.md index 90be24d9f6f5f..d2cc912c824ed 100644 --- a/docs/visual-basic/language-reference/xmldoc/returns.md +++ b/docs/visual-basic/language-reference/xmldoc/returns.md @@ -22,7 +22,7 @@ Specifies the return value of the property or function. ## Remarks Use the `` tag in the comment for a method declaration to describe the return value. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to explain what the `DoesRecordExist` function returns. @@ -31,4 +31,4 @@ Specifies the return value of the property or function. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/see.md b/docs/visual-basic/language-reference/xmldoc/see.md index 184330a3d30a9..4f89d9b48865f 100644 --- a/docs/visual-basic/language-reference/xmldoc/see.md +++ b/docs/visual-basic/language-reference/xmldoc/see.md @@ -20,9 +20,9 @@ Specifies a link to another member. A reference to a member or field that is available to be called from the current compilation environment. The compiler checks that the given code element exists and passes `member` to the element name in the output XML. `member` must appear within double quotation marks (" "). ## Remarks - Use the `` tag to specify a link from within text. Use [\](../../../visual-basic/language-reference/xmldoc/seealso.md) to indicate text that you might want to appear in a "See Also" section. + Use the `` tag to specify a link from within text. Use [\](seealso.md) to indicate text that you might want to appear in a "See Also" section. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag in the `UpdateRecord` remarks section to refer to the `DoesRecordExist` method. @@ -31,4 +31,4 @@ Specifies a link to another member. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/seealso.md b/docs/visual-basic/language-reference/xmldoc/seealso.md index 5b8adf61589bd..8756139d4c9a6 100644 --- a/docs/visual-basic/language-reference/xmldoc/seealso.md +++ b/docs/visual-basic/language-reference/xmldoc/seealso.md @@ -20,9 +20,9 @@ Specifies a link that appears in the See Also section. A reference to a member or field that is available to be called from the current compilation environment. The compiler checks that the given code element exists and passes `member` to the element name in the output XML. `member` must appear within double quotation marks (" "). ## Remarks - Use the `` tag to specify the text that you want to appear in a See Also section. Use [\](../../../visual-basic/language-reference/xmldoc/see.md) to specify a link from within text. + Use the `` tag to specify the text that you want to appear in a See Also section. Use [\](see.md) to specify a link from within text. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag in the `DoesRecordExist` remarks section to refer to the `UpdateRecord` method. @@ -31,4 +31,4 @@ Specifies a link that appears in the See Also section. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/summary.md b/docs/visual-basic/language-reference/xmldoc/summary.md index 7b16f3af5b885..9442a40382351 100644 --- a/docs/visual-basic/language-reference/xmldoc/summary.md +++ b/docs/visual-basic/language-reference/xmldoc/summary.md @@ -20,11 +20,11 @@ Specifies the summary of the member. A summary of the object. ## Remarks - Use the `` tag to describe a type or a type member. Use [\](../../../visual-basic/language-reference/xmldoc/remarks.md) to add supplemental information to a type description. + Use the `` tag to describe a type or a type member. Use [\](remarks.md) to add supplemental information to a type description. The text for the `` tag is the only source of information about the type in IntelliSense, and is also displayed in the Object Browser. For information about the Object Browser, see [Viewing the Structure of Code](/visualstudio/ide/viewing-the-structure-of-code). - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to describe the `ResetCounter` method and `Counter` property. @@ -33,4 +33,4 @@ Specifies the summary of the member. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/typeparam.md b/docs/visual-basic/language-reference/xmldoc/typeparam.md index 1ba85b39772bc..b572ca46526c0 100644 --- a/docs/visual-basic/language-reference/xmldoc/typeparam.md +++ b/docs/visual-basic/language-reference/xmldoc/typeparam.md @@ -25,7 +25,7 @@ Defines a type parameter name and description. ## Remarks Use the `` tag in the comment for a generic type or generic member declaration to describe one of the type parameters. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to describe the `id` parameter. @@ -34,4 +34,4 @@ Defines a type parameter name and description. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/language-reference/xmldoc/value.md b/docs/visual-basic/language-reference/xmldoc/value.md index 39ac04887d6a7..eed2459668268 100644 --- a/docs/visual-basic/language-reference/xmldoc/value.md +++ b/docs/visual-basic/language-reference/xmldoc/value.md @@ -20,9 +20,9 @@ Specifies the description of a property. A description for the property. ## Remarks - Use the `` tag to describe a property. Note that when you add a property using the code wizard in the Visual Studio development environment, it will add a [\](../../../visual-basic/language-reference/xmldoc/summary.md) tag for the new property. You should then manually add a `` tag to describe the value that the property represents. + Use the `` tag to describe a property. Note that when you add a property using the code wizard in the Visual Studio development environment, it will add a [\](summary.md) tag for the new property. You should then manually add a `` tag to describe the value that the property represents. - Compile with [-doc](../../../visual-basic/reference/command-line-compiler/doc.md) to process documentation comments to a file. + Compile with [-doc](../../reference/command-line-compiler/doc.md) to process documentation comments to a file. ## Example This example uses the `` tag to describe what value the `Counter` property holds. @@ -31,4 +31,4 @@ Specifies the description of a property. ## See also -- [XML Comment Tags](../../../visual-basic/language-reference/xmldoc/index.md) +- [XML Comment Tags](index.md) diff --git a/docs/visual-basic/misc/a-delimiter-cannot-be-nothing-or-an-empty-string.md b/docs/visual-basic/misc/a-delimiter-cannot-be-nothing-or-an-empty-string.md index db5df39bea49b..2d92a52232d87 100644 --- a/docs/visual-basic/misc/a-delimiter-cannot-be-nothing-or-an-empty-string.md +++ b/docs/visual-basic/misc/a-delimiter-cannot-be-nothing-or-an-empty-string.md @@ -16,6 +16,6 @@ The `TextFieldParser` is unable to read from the file because the `Delimiters` p - - -- [How to: Read From Comma-Delimited Text Files](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md) -- [TextFieldParser Object](../../visual-basic/language-reference/objects/textfieldparser-object.md) -- [Parsing Text Files with the TextFieldParser Object](../../visual-basic/developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) +- [How to: Read From Comma-Delimited Text Files](../developing-apps/programming/drives-directories-files/how-to-read-from-comma-delimited-text-files.md) +- [TextFieldParser Object](../language-reference/objects/textfieldparser-object.md) +- [Parsing Text Files with the TextFieldParser Object](../developing-apps/programming/drives-directories-files/parsing-text-files-with-the-textfieldparser-object.md) diff --git a/docs/visual-basic/misc/a-log-has-already-been-created-with-this-name-on-this-machine.md b/docs/visual-basic/misc/a-log-has-already-been-created-with-this-name-on-this-machine.md index b39c3dab78005..d60efb6c81ab5 100644 --- a/docs/visual-basic/misc/a-log-has-already-been-created-with-this-name-on-this-machine.md +++ b/docs/visual-basic/misc/a-log-has-already-been-created-with-this-name-on-this-machine.md @@ -15,9 +15,9 @@ An attempt has been made to create a log with a name that is already in use. ## See also - [My.Application.Log](xref:Microsoft.VisualBasic.ApplicationServices.ApplicationBase.Log) -- [How to: Write Log Messages](../../visual-basic/developing-apps/programming/log-info/how-to-write-log-messages.md) -- [How to: Log Messages When the Application Starts or Shuts Down](../../visual-basic/developing-apps/programming/log-info/how-to-log-messages-when-the-application-starts-or-shuts-down.md) -- [How to: Write to an Application Event Log](../../visual-basic/developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md) -- [Working with Application Logs](../../visual-basic/developing-apps/programming/log-info/working-with-application-logs.md) -- [Walkthrough: Determining Where My.Application.Log Writes Information](../../visual-basic/developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md) -- [Walkthrough: Changing Where My.Application.Log Writes Information](../../visual-basic/developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md) +- [How to: Write Log Messages](../developing-apps/programming/log-info/how-to-write-log-messages.md) +- [How to: Log Messages When the Application Starts or Shuts Down](../developing-apps/programming/log-info/how-to-log-messages-when-the-application-starts-or-shuts-down.md) +- [How to: Write to an Application Event Log](../developing-apps/programming/log-info/how-to-write-to-an-application-event-log.md) +- [Working with Application Logs](../developing-apps/programming/log-info/working-with-application-logs.md) +- [Walkthrough: Determining Where My.Application.Log Writes Information](../developing-apps/programming/log-info/walkthrough-determining-where-my-application-log-writes-information.md) +- [Walkthrough: Changing Where My.Application.Log Writes Information](../developing-apps/programming/log-info/walkthrough-changing-where-my-application-log-writes-information.md) diff --git a/docs/visual-basic/misc/add-failed-duplicate-key-value-supplied.md b/docs/visual-basic/misc/add-failed-duplicate-key-value-supplied.md index fee0054d88eae..d738002876a1f 100644 --- a/docs/visual-basic/misc/add-failed-duplicate-key-value-supplied.md +++ b/docs/visual-basic/misc/add-failed-duplicate-key-value-supplied.md @@ -14,4 +14,4 @@ An `Add` operation failed because the key value is the same as another key value ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/address-is-not-a-valid-remote-file-address.md b/docs/visual-basic/misc/address-is-not-a-valid-remote-file-address.md index c467b275944bb..9eb3055d7fbe7 100644 --- a/docs/visual-basic/misc/address-is-not-a-valid-remote-file-address.md +++ b/docs/visual-basic/misc/address-is-not-a-valid-remote-file-address.md @@ -16,4 +16,4 @@ ms.assetid: 2c312242-6c42-4754-a1f5-7e801a542604 - [My.Computer.Network.UploadFile](xref:Microsoft.VisualBasic.Devices.Network.UploadFile%2A) - [My.Computer.Network.DownloadFile](xref:Microsoft.VisualBasic.Devices.Network.DownloadFile%2A) -- [How to: Download a File](../../visual-basic/developing-apps/programming/computer-resources/how-to-download-a-file.md) +- [How to: Download a File](../developing-apps/programming/computer-resources/how-to-download-a-file.md) diff --git a/docs/visual-basic/misc/all-field-widths-except-the-last-element-must-be-greater-than-zero.md b/docs/visual-basic/misc/all-field-widths-except-the-last-element-must-be-greater-than-zero.md index 06e4dbcaaf2b9..3883bf272ac7d 100644 --- a/docs/visual-basic/misc/all-field-widths-except-the-last-element-must-be-greater-than-zero.md +++ b/docs/visual-basic/misc/all-field-widths-except-the-last-element-must-be-greater-than-zero.md @@ -18,5 +18,5 @@ All field widths, except the last element, must be greater than zero. A field wi - - -- [How to: Read From Fixed-width Text Files](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md) -- [TextFieldParser Object](../../visual-basic/language-reference/objects/textfieldparser-object.md) +- [How to: Read From Fixed-width Text Files](../developing-apps/programming/drives-directories-files/how-to-read-from-fixed-width-text-files.md) +- [TextFieldParser Object](../language-reference/objects/textfieldparser-object.md) diff --git a/docs/visual-basic/misc/an-invalid-name-was-specified-for-the-event-log.md b/docs/visual-basic/misc/an-invalid-name-was-specified-for-the-event-log.md index e218d4978ae50..bcbebe6be06a1 100644 --- a/docs/visual-basic/misc/an-invalid-name-was-specified-for-the-event-log.md +++ b/docs/visual-basic/misc/an-invalid-name-was-specified-for-the-event-log.md @@ -16,5 +16,5 @@ An invalid name was specified for the event log. Usually this is a result of inv ## See also -- [How to: Parse File Paths](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) -- [How to: Rename a File](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-rename-a-file.md) +- [How to: Parse File Paths](../developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [How to: Rename a File](../developing-apps/programming/drives-directories-files/how-to-rename-a-file.md) diff --git a/docs/visual-basic/misc/application-defined-or-object-defined-error.md b/docs/visual-basic/misc/application-defined-or-object-defined-error.md index baaa2847ba6c5..9671ecfae4f6f 100644 --- a/docs/visual-basic/misc/application-defined-or-object-defined-error.md +++ b/docs/visual-basic/misc/application-defined-or-object-defined-error.md @@ -14,4 +14,4 @@ An application-defined or user-defined error occurred. Check the error. ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/argument-argument1-must-be-less-than-or-equal-to-the-length-of-argument2.md b/docs/visual-basic/misc/argument-argument1-must-be-less-than-or-equal-to-the-length-of-argument2.md index c458d39bc8347..f4a82a0e2ff94 100644 --- a/docs/visual-basic/misc/argument-argument1-must-be-less-than-or-equal-to-the-length-of-argument2.md +++ b/docs/visual-basic/misc/argument-argument1-must-be-less-than-or-equal-to-the-length-of-argument2.md @@ -16,4 +16,4 @@ An argument's length exceeds the allowable limit, which is determined by the sec ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-cannot-be-an-empty-string-or-nothing.md b/docs/visual-basic/misc/argument-argumentname-cannot-be-an-empty-string-or-nothing.md index 175cd71ce5caa..9cfa25f539dc1 100644 --- a/docs/visual-basic/misc/argument-argumentname-cannot-be-an-empty-string-or-nothing.md +++ b/docs/visual-basic/misc/argument-argumentname-cannot-be-an-empty-string-or-nothing.md @@ -14,6 +14,6 @@ The argument requires a value other than an empty string ("") or `Nothing`. This ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) -- [Nothing](../../visual-basic/language-reference/nothing.md) +- [Error Types](../programming-guide/language-features/error-types.md) +- [Nothing](../language-reference/nothing.md) - diff --git a/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-a-numeric-value.md b/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-a-numeric-value.md index d2bfb6813b75f..b127ee24c2371 100644 --- a/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-a-numeric-value.md +++ b/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-a-numeric-value.md @@ -14,4 +14,4 @@ A conversion attempted to convert a variable, such as a string, to a numeric val ## See also -- [Type Conversions in Visual Basic](../../visual-basic/programming-guide/language-features/data-types/type-conversions.md) +- [Type Conversions in Visual Basic](../programming-guide/language-features/data-types/type-conversions.md) diff --git a/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-date.md b/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-date.md index 0c81e79d76c76..4d269d913058a 100644 --- a/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-date.md +++ b/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-date.md @@ -14,5 +14,5 @@ A conversion attempted to change a variable to type `Date`, but the value is not ## See also -- [Type Conversions in Visual Basic](../../visual-basic/programming-guide/language-features/data-types/type-conversions.md) -- [Date Data Type](../../visual-basic/language-reference/data-types/date-data-type.md) +- [Type Conversions in Visual Basic](../programming-guide/language-features/data-types/type-conversions.md) +- [Date Data Type](../language-reference/data-types/date-data-type.md) diff --git a/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-typename.md b/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-typename.md index 595092da2cc2c..8ca67d3114822 100644 --- a/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-typename.md +++ b/docs/visual-basic/misc/argument-argumentname-cannot-be-converted-to-type-typename.md @@ -14,4 +14,4 @@ A conversion attempts to change an argument to a type that is not valid. ## See also -- [Conversion Functions](../../visual-basic/language-reference/functions/conversion-functions.md) +- [Conversion Functions](../language-reference/functions/conversion-functions.md) diff --git a/docs/visual-basic/misc/argument-argumentname-is-not-a-valid-value.md b/docs/visual-basic/misc/argument-argumentname-is-not-a-valid-value.md index 4bd3e38718dec..3786c11ea56ee 100644 --- a/docs/visual-basic/misc/argument-argumentname-is-not-a-valid-value.md +++ b/docs/visual-basic/misc/argument-argumentname-is-not-a-valid-value.md @@ -16,4 +16,4 @@ An argument's value is not valid. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-is-not-valid-for-the-array.md b/docs/visual-basic/misc/argument-argumentname-is-not-valid-for-the-array.md index cae9ca72fdbf9..f22eda278c5d0 100644 --- a/docs/visual-basic/misc/argument-argumentname-is-not-valid-for-the-array.md +++ b/docs/visual-basic/misc/argument-argumentname-is-not-valid-for-the-array.md @@ -14,5 +14,5 @@ An array contains an argument that is not valid. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) -- [Arrays](../../visual-basic/programming-guide/language-features/arrays/index.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Arrays](../programming-guide/language-features/arrays/index.md) diff --git a/docs/visual-basic/misc/argument-argumentname-is-nothing-or-empty.md b/docs/visual-basic/misc/argument-argumentname-is-nothing-or-empty.md index 4f4a382ac84aa..659bce1bfc19a 100644 --- a/docs/visual-basic/misc/argument-argumentname-is-nothing-or-empty.md +++ b/docs/visual-basic/misc/argument-argumentname-is-nothing-or-empty.md @@ -15,5 +15,5 @@ An argument name is not valid because it is initialized to `Nothing` or is empty ## See also - [My.Application.Info.DirectoryPath](xref:Microsoft.VisualBasic.ApplicationServices.AssemblyInfo.DirectoryPath) -- [How to: Parse File Paths](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) -- [Nothing](../../visual-basic/language-reference/nothing.md) +- [How to: Parse File Paths](../developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [Nothing](../language-reference/nothing.md) diff --git a/docs/visual-basic/misc/argument-argumentname-is-nothing.md b/docs/visual-basic/misc/argument-argumentname-is-nothing.md index db1d17b86bee7..8c1b83e54d0a3 100644 --- a/docs/visual-basic/misc/argument-argumentname-is-nothing.md +++ b/docs/visual-basic/misc/argument-argumentname-is-nothing.md @@ -16,4 +16,4 @@ An expression contains a null argument. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-0-or-equal-to-1.md b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-0-or-equal-to-1.md index 44896c1eedc1d..60637ce6779a4 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-0-or-equal-to-1.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-0-or-equal-to-1.md @@ -16,4 +16,4 @@ An argument's value is less than 0 but not equal to -1. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1-1.md b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1-1.md index 579836ed6e9b1..125d1a0685116 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1-1.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1-1.md @@ -16,4 +16,4 @@ An argument's value is less than -1. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1.md b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1.md index 31fcba145b50d..35e7533a2d715 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-1.md @@ -16,4 +16,4 @@ An argument's value is less than 1. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero-1.md b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero-1.md index 2d473b6d95db2..8fb45da91998f 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero-1.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero-1.md @@ -16,4 +16,4 @@ An argument value is less than zero. Argument values must be greater than or equ ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero.md b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero.md index b97f4f5054194..5cf9ebe0f6f40 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-or-equal-to-zero.md @@ -16,4 +16,4 @@ An argument is not valid because it is less than zero. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-zero.md b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-zero.md index 70389f6806cf9..6821cc0b8c27d 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-zero.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-greater-than-zero.md @@ -16,4 +16,4 @@ An argument is not valid because it is less than or equal to zero. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-in-the-range-of-32768-to-65535.md b/docs/visual-basic/misc/argument-argumentname-must-be-in-the-range-of-32768-to-65535.md index e55de04adbb0d..59ebda25c2cdd 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-in-the-range-of-32768-to-65535.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-in-the-range-of-32768-to-65535.md @@ -16,4 +16,4 @@ An argument's value falls outside the allowable range of -32,768 to 65,535. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-0-to-99.md b/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-0-to-99.md index 95696cc390fa0..b3f00851aeb14 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-0-to-99.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-0-to-99.md @@ -16,4 +16,4 @@ An argument is not valid because it falls outside of the range 0 to 99. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-1-to-255.md b/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-1-to-255.md index b70af322e5757..d65564ef5bbbd 100644 --- a/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-1-to-255.md +++ b/docs/visual-basic/misc/argument-argumentname-must-be-within-the-range-1-to-255.md @@ -16,4 +16,4 @@ An argument is not valid because it falls outside of the range 0 to 255. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-argumentname1-must-be-less-than-or-equal-the-length-of-argumentname2.md b/docs/visual-basic/misc/argument-argumentname1-must-be-less-than-or-equal-the-length-of-argumentname2.md index 03c78d6cfcdf2..da46449e70b76 100644 --- a/docs/visual-basic/misc/argument-argumentname1-must-be-less-than-or-equal-the-length-of-argumentname2.md +++ b/docs/visual-basic/misc/argument-argumentname1-must-be-less-than-or-equal-the-length-of-argumentname2.md @@ -12,4 +12,4 @@ The length of a supplied argument exceeds the length of the argument it is repla ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/argument-basepath-must-be-a-path-to-a-folder.md b/docs/visual-basic/misc/argument-basepath-must-be-a-path-to-a-folder.md index 42c0dcf2f0d41..25c422eed470f 100644 --- a/docs/visual-basic/misc/argument-basepath-must-be-a-path-to-a-folder.md +++ b/docs/visual-basic/misc/argument-basepath-must-be-a-path-to-a-folder.md @@ -15,4 +15,4 @@ The argument `BasePath` must consist of a path to a folder. You may be parsing a - - - -- [How to: Parse File Paths](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [How to: Parse File Paths](../developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) diff --git a/docs/visual-basic/misc/argument-cannot-be-an-empty-string.md b/docs/visual-basic/misc/argument-cannot-be-an-empty-string.md index f9b9cea226a31..9aeb430052c72 100644 --- a/docs/visual-basic/misc/argument-cannot-be-an-empty-string.md +++ b/docs/visual-basic/misc/argument-cannot-be-an-empty-string.md @@ -12,4 +12,4 @@ An argument has been defined as an empty string (""). ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/argument-life-cannot-be-zero.md b/docs/visual-basic/misc/argument-life-cannot-be-zero.md index 40d3c569f45b5..5b3a3c5e98189 100644 --- a/docs/visual-basic/misc/argument-life-cannot-be-zero.md +++ b/docs/visual-basic/misc/argument-life-cannot-be-zero.md @@ -16,4 +16,4 @@ An argument for `Life`, which must be a `Double` that specifies the length of us ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-nper-must-be-greater-than-zero.md b/docs/visual-basic/misc/argument-nper-must-be-greater-than-zero.md index 9b2eff313a1cb..82e1574e4f17b 100644 --- a/docs/visual-basic/misc/argument-nper-must-be-greater-than-zero.md +++ b/docs/visual-basic/misc/argument-nper-must-be-greater-than-zero.md @@ -16,4 +16,4 @@ The `NPer` function, which returns a `Double` specifying the number of periods f ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-path-is-nothing-or-empty.md b/docs/visual-basic/misc/argument-path-is-nothing-or-empty.md index 0feaba6b63261..debdb0ba910d8 100644 --- a/docs/visual-basic/misc/argument-path-is-nothing-or-empty.md +++ b/docs/visual-basic/misc/argument-path-is-nothing-or-empty.md @@ -15,5 +15,5 @@ A path name is not valid because it is initialized to `Nothing` or is empty. A p ## See also - [My.Application.Info.DirectoryPath](xref:Microsoft.VisualBasic.ApplicationServices.AssemblyInfo.DirectoryPath) -- [How to: Parse File Paths](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) -- [Nothing](../../visual-basic/language-reference/nothing.md) +- [How to: Parse File Paths](../developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [Nothing](../language-reference/nothing.md) diff --git a/docs/visual-basic/misc/argument-per-is-not-valid.md b/docs/visual-basic/misc/argument-per-is-not-valid.md index 7ac750a4d1402..07cbbb8a5820f 100644 --- a/docs/visual-basic/misc/argument-per-is-not-valid.md +++ b/docs/visual-basic/misc/argument-per-is-not-valid.md @@ -14,4 +14,4 @@ An argument supplied for `Per`, which must be a `Double` specifying payment peri ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-period-must-be-less-than-or-equal-to-argument-life.md b/docs/visual-basic/misc/argument-period-must-be-less-than-or-equal-to-argument-life.md index 8acbd6ad3a701..7b3c8d9bca660 100644 --- a/docs/visual-basic/misc/argument-period-must-be-less-than-or-equal-to-argument-life.md +++ b/docs/visual-basic/misc/argument-period-must-be-less-than-or-equal-to-argument-life.md @@ -14,4 +14,4 @@ The value of the `Period` argument, which specifies the period for which asset d ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/argument-value-pathname-contains-characters-that-are-not-valid-in-a-path-name.md b/docs/visual-basic/misc/argument-value-pathname-contains-characters-that-are-not-valid-in-a-path-name.md index 0e8e1b7d2c6c9..17e321355bbec 100644 --- a/docs/visual-basic/misc/argument-value-pathname-contains-characters-that-are-not-valid-in-a-path-name.md +++ b/docs/visual-basic/misc/argument-value-pathname-contains-characters-that-are-not-valid-in-a-path-name.md @@ -15,4 +15,4 @@ A path name contains one or more characters that are not valid. ## See also - [My.Application.Info.DirectoryPath](xref:Microsoft.VisualBasic.ApplicationServices.AssemblyInfo.DirectoryPath) -- [How to: Parse File Paths](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [How to: Parse File Paths](../developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) diff --git a/docs/visual-basic/misc/arguments-are-not-valid.md b/docs/visual-basic/misc/arguments-are-not-valid.md index bdfde1ee3120f..1286b235ef1b9 100644 --- a/docs/visual-basic/misc/arguments-are-not-valid.md +++ b/docs/visual-basic/misc/arguments-are-not-valid.md @@ -16,4 +16,4 @@ Arguments that are not valid are being passed to a function or subroutine. ## See also -- [Passing Arguments by Value and by Reference](../../visual-basic/programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) +- [Passing Arguments by Value and by Reference](../programming-guide/language-features/procedures/passing-arguments-by-value-and-by-reference.md) diff --git a/docs/visual-basic/misc/array-dimensions-do-not-match-those-specified-in-the-vbfixedarray-attribute.md b/docs/visual-basic/misc/array-dimensions-do-not-match-those-specified-in-the-vbfixedarray-attribute.md index 367b98c3ff84f..10aeb3aa9e5ea 100644 --- a/docs/visual-basic/misc/array-dimensions-do-not-match-those-specified-in-the-vbfixedarray-attribute.md +++ b/docs/visual-basic/misc/array-dimensions-do-not-match-those-specified-in-the-vbfixedarray-attribute.md @@ -15,5 +15,5 @@ Your array's dimensions do not match the dimensions you have specified in the `V ## See also - [Arrays in Visual Basic](../programming-guide/language-features/arrays/index.md) -- [ReDim Statement](../../visual-basic/language-reference/statements/redim-statement.md) +- [ReDim Statement](../language-reference/statements/redim-statement.md) - diff --git a/docs/visual-basic/misc/automation-object-does-not-have-a-default-value.md b/docs/visual-basic/misc/automation-object-does-not-have-a-default-value.md index 359def023ff55..1d422883c4f3b 100644 --- a/docs/visual-basic/misc/automation-object-does-not-have-a-default-value.md +++ b/docs/visual-basic/misc/automation-object-does-not-have-a-default-value.md @@ -14,4 +14,4 @@ Visual Basic cannot determine the default member for the specified object. ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/bad-record-number.md b/docs/visual-basic/misc/bad-record-number.md index 0e7c123a34f0f..de33218ccac09 100644 --- a/docs/visual-basic/misc/bad-record-number.md +++ b/docs/visual-basic/misc/bad-record-number.md @@ -14,4 +14,4 @@ The record number in `a FileGet`, `FilePut`, `FileGetObject`, or `FilePutObject` ## See also -- [Option Explicit Statement](../../visual-basic/language-reference/statements/option-explicit-statement.md) +- [Option Explicit Statement](../language-reference/statements/option-explicit-statement.md) diff --git a/docs/visual-basic/misc/bc2000.md b/docs/visual-basic/misc/bc2000.md index 63b1e4beb10d9..ff11e5029b7dd 100644 --- a/docs/visual-basic/misc/bc2000.md +++ b/docs/visual-basic/misc/bc2000.md @@ -19,4 +19,4 @@ An error occurred while initializing the program. This may be a result of cancel ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/bc2001.md b/docs/visual-basic/misc/bc2001.md index 117c4a425b079..dad69c1c532ac 100644 --- a/docs/visual-basic/misc/bc2001.md +++ b/docs/visual-basic/misc/bc2001.md @@ -19,4 +19,4 @@ The specified file could not be located. This may be a result of supplying an in ## See also -- [How to: Parse File Paths](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [How to: Parse File Paths](../developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) diff --git a/docs/visual-basic/misc/bc2003.md b/docs/visual-basic/misc/bc2003.md index ec9d4b5e25abd..acc1a79af4e76 100644 --- a/docs/visual-basic/misc/bc2003.md +++ b/docs/visual-basic/misc/bc2003.md @@ -19,4 +19,4 @@ A response file has been specified more than once. Response files contain compil ## See also -- [Visual Basic Compiler Options Listed by Category](../../visual-basic/reference/command-line-compiler/compiler-options-listed-by-category.md) +- [Visual Basic Compiler Options Listed by Category](../reference/command-line-compiler/compiler-options-listed-by-category.md) diff --git a/docs/visual-basic/misc/bc2006.md b/docs/visual-basic/misc/bc2006.md index 8fb4e395d86a2..b4f6645ec20db 100644 --- a/docs/visual-basic/misc/bc2006.md +++ b/docs/visual-basic/misc/bc2006.md @@ -19,4 +19,4 @@ A required argument has been omitted. ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/bc2009.md b/docs/visual-basic/misc/bc2009.md index 6a4570ed66a09..74b0e5783cde6 100644 --- a/docs/visual-basic/misc/bc2009.md +++ b/docs/visual-basic/misc/bc2009.md @@ -23,5 +23,5 @@ The text that follows the option is not a plus sign (+) or a minus sign (-). ## See also -- [Visual Basic Compiler Options Listed Alphabetically](../../visual-basic/reference/command-line-compiler/compiler-options-listed-alphabetically.md) -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Visual Basic Compiler Options Listed Alphabetically](../reference/command-line-compiler/compiler-options-listed-alphabetically.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/bc2011.md b/docs/visual-basic/misc/bc2011.md index cf7b7b9ae3416..2b278d3612423 100644 --- a/docs/visual-basic/misc/bc2011.md +++ b/docs/visual-basic/misc/bc2011.md @@ -22,4 +22,4 @@ The file you are attempting to access is unavailable. ## See also - -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/bc2015.md b/docs/visual-basic/misc/bc2015.md index 67273781cc376..c5a25f48bf763 100644 --- a/docs/visual-basic/misc/bc2015.md +++ b/docs/visual-basic/misc/bc2015.md @@ -19,7 +19,7 @@ The specified file cannot be written to because it is a binary file. ## See also -- [Writing to Files](../../visual-basic/developing-apps/programming/drives-directories-files/writing-to-files.md) -- [How to: Parse File Paths](../../visual-basic/developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) +- [Writing to Files](../developing-apps/programming/drives-directories-files/writing-to-files.md) +- [How to: Parse File Paths](../developing-apps/programming/drives-directories-files/how-to-parse-file-paths.md) - [My.Computer.FileSystem.WriteAllText](xref:Microsoft.VisualBasic.FileIO.FileSystem.WriteAllText%2A) - [My.Computer.FileSystem.WriteAllBytes](xref:Microsoft.VisualBasic.MyServices.FileSystemProxy.WriteAllBytes%2A) diff --git a/docs/visual-basic/misc/bc2020.md b/docs/visual-basic/misc/bc2020.md index 22067f77f8215..3b5dcc7334905 100644 --- a/docs/visual-basic/misc/bc2020.md +++ b/docs/visual-basic/misc/bc2020.md @@ -19,4 +19,4 @@ The compiler maximum of 100 errors has been reached. ## See also -- [Error Types](../../visual-basic/programming-guide/language-features/error-types.md) +- [Error Types](../programming-guide/language-features/error-types.md) diff --git a/docs/visual-basic/misc/bc2023.md b/docs/visual-basic/misc/bc2023.md index d0f2c28126867..be413f4191028 100644 --- a/docs/visual-basic/misc/bc2023.md +++ b/docs/visual-basic/misc/bc2023.md @@ -23,5 +23,5 @@ The `/win32resource` and `/win32icon` options are mutually exclusive, because th ## See also -- [-win32icon](../../visual-basic/reference/command-line-compiler/win32icon.md) -- [-win32resource](../../visual-basic/reference/command-line-compiler/win32resource.md) +- [-win32icon](../reference/command-line-compiler/win32icon.md) +- [-win32resource](../reference/command-line-compiler/win32resource.md) diff --git a/docs/visual-basic/misc/bc2025.md b/docs/visual-basic/misc/bc2025.md index 13f23b5c0ac66..de06c665a1664 100644 --- a/docs/visual-basic/misc/bc2025.md +++ b/docs/visual-basic/misc/bc2025.md @@ -21,5 +21,5 @@ The `/noconfig` option tells the compiler not to compile with the Vbc.rsp file. ## See also -- [-noconfig](../../visual-basic/reference/command-line-compiler/noconfig.md) -- [@ (Specify Response File)](../../visual-basic/reference/command-line-compiler/specify-response-file.md) +- [-noconfig](../reference/command-line-compiler/noconfig.md) +- [@ (Specify Response File)](../reference/command-line-compiler/specify-response-file.md) diff --git a/docs/visual-basic/misc/bc2027.md b/docs/visual-basic/misc/bc2027.md index 56f79ac7921c3..7cdf25f974f1e 100644 --- a/docs/visual-basic/misc/bc2027.md +++ b/docs/visual-basic/misc/bc2027.md @@ -25,4 +25,4 @@ cannot send error report automatically. Please visit 'https://go.microsoft.com/f ## See also -- [-errorreport](../../visual-basic/reference/command-line-compiler/errorreport.md) +- [-errorreport](../reference/command-line-compiler/errorreport.md) diff --git a/docs/visual-basic/misc/bc2028.md b/docs/visual-basic/misc/bc2028.md index dad08bb1d8db1..574e08f3da42e 100644 --- a/docs/visual-basic/misc/bc2028.md +++ b/docs/visual-basic/misc/bc2028.md @@ -11,7 +11,7 @@ ms.assetid: 32d1bd57-947b-4cad-a634-9981db3c885a # option '\