Skip to content

Commit 2e9bf90

Browse files
authored
Drop styled link text (#16042)
1 parent 6d3ed8a commit 2e9bf90

File tree

49 files changed

+141
-141
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

49 files changed

+141
-141
lines changed

aspnetcore/blazor/components.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,7 @@ The following `ParentComponent` can provide content for rendering the `ChildComp
164164

165165
## Attribute splatting and arbitrary parameters
166166

167-
Components can capture and render additional attributes in addition to the component's declared parameters. Additional attributes can be captured in a dictionary and then *splatted* onto an element when the component is rendered using the [@attributes](xref:mvc/views/razor#attributes) Razor directive. This scenario is useful when defining a component that produces a markup element that supports a variety of customizations. For example, it can be tedious to define attributes separately for an `<input>` that supports many parameters.
167+
Components can capture and render additional attributes in addition to the component's declared parameters. Additional attributes can be captured in a dictionary and then *splatted* onto an element when the component is rendered using the [`@attributes`](xref:mvc/views/razor#attributes) Razor directive. This scenario is useful when defining a component that produces a markup element that supports a variety of customizations. For example, it can be tedious to define attributes separately for an `<input>` that supports many parameters.
168168

169169
In the following example, the first `<input>` element (`id="useIndividualParams"`) uses individual component parameters, while the second `<input>` element (`id="useAttributesDict"`) uses attribute splatting:
170170

@@ -280,7 +280,7 @@ The rendered `<div>` in the `Parent` component contains `extra="10"` when passed
280280

281281
## Data binding
282282

283-
Data binding to both components and DOM elements is accomplished with the [@bind](xref:mvc/views/razor#bind) attribute. The following example binds a `CurrentValue` property to the text box's value:
283+
Data binding to both components and DOM elements is accomplished with the [`@bind`](xref:mvc/views/razor#bind) attribute. The following example binds a `CurrentValue` property to the text box's value:
284284

285285
```cshtml
286286
<input @bind="CurrentValue" />
@@ -308,7 +308,7 @@ Using `@bind` with the `CurrentValue` property (`<input @bind="CurrentValue" />`
308308

309309
When the component is rendered, the `value` of the input element comes from the `CurrentValue` property. When the user types in the text box and changes element focus, the `onchange` event is fired and the `CurrentValue` property is set to the changed value. In reality, the code generation is more complex because `@bind` handles cases where type conversions are performed. In principle, `@bind` associates the current value of an expression with a `value` attribute and handles changes using the registered handler.
310310

311-
In addition to handling `onchange` events with `@bind` syntax, a property or field can be bound using other events by specifying an [@bind-value](xref:mvc/views/razor#bind) attribute with an `event` parameter ([@bind-value:event](xref:mvc/views/razor#bind)). The following example binds the `CurrentValue` property for the `oninput` event:
311+
In addition to handling `onchange` events with `@bind` syntax, a property or field can be bound using other events by specifying an [`@bind-value`](xref:mvc/views/razor#bind) attribute with an `event` parameter ([`@bind-value:event`](xref:mvc/views/razor#bind)). The following example binds the `CurrentValue` property for the `oninput` event:
312312

313313
```cshtml
314314
<input @bind-value="CurrentValue" @bind-value:event="oninput" />
@@ -377,7 +377,7 @@ For information on how to set the user's culture, see the [Localization](#locali
377377

378378
**Format strings**
379379

380-
Data binding works with <xref:System.DateTime> format strings using [@bind:format](xref:mvc/views/razor#bind). Other format expressions, such as currency or number formats, aren't available at this time.
380+
Data binding works with <xref:System.DateTime> format strings using [`@bind:format`](xref:mvc/views/razor#bind). Other format expressions, such as currency or number formats, aren't available at this time.
381381

382382
```cshtml
383383
<input @bind="StartDate" @bind:format="yyyy-MM-dd" />
@@ -491,7 +491,7 @@ In general, a property can be bound to a corresponding event handler using `@bin
491491

492492
## Event handling
493493

494-
Razor components provide event handling features. For an HTML element attribute named `on{EVENT}` (for example, `onclick` and `onsubmit`) with a delegate-typed value, Razor components treats the attribute's value as an event handler. The attribute's name is always formatted [@on{EVENT}](xref:mvc/views/razor#onevent).
494+
Razor components provide event handling features. For an HTML element attribute named `on{EVENT}` (for example, `onclick` and `onsubmit`) with a delegate-typed value, Razor components treats the attribute's value as an event handler. The attribute's name is always formatted [`@on{EVENT}`](xref:mvc/views/razor#onevent).
495495

496496
The following code calls the `UpdateHeading` method when the button is selected in the UI:
497497

@@ -644,7 +644,7 @@ Prefer the strongly typed `EventCallback<T>` over `EventCallback`. `EventCallbac
644644

645645
### Prevent default actions
646646

647-
Use the [@on{EVENT}:preventDefault](xref:mvc/views/razor#oneventpreventdefault) directive attribute to prevent the default action for an event.
647+
Use the [`@on{EVENT}:preventDefault`](xref:mvc/views/razor#oneventpreventdefault) directive attribute to prevent the default action for an event.
648648

649649
When a key is selected on an input device and the element focus is on a text box, a browser normally displays the key's character in the text box. In the following example, the default behavior is prevented by specifying the `@onkeypress:preventDefault` directive attribute. The counter increments, and the **+** key isn't captured into the `<input>` element's value:
650650

@@ -676,7 +676,7 @@ An event handler isn't required to prevent the default action. The event handler
676676

677677
### Stop event propagation
678678

679-
Use the [@on{EVENT}:stopPropagation](xref:mvc/views/razor#oneventstoppropagation) directive attribute to stop event propagation.
679+
Use the [`@on{EVENT}:stopPropagation`](xref:mvc/views/razor#oneventstoppropagation) directive attribute to stop event propagation.
680680

681681
In the following example, selecting the check box prevents click events from the second child `<div>` from propagating to the parent `<div>`:
682682

@@ -834,7 +834,7 @@ Password:
834834

835835
Component references provide a way to reference a component instance so that you can issue commands to that instance, such as `Show` or `Reset`. To capture a component reference:
836836

837-
* Add an [@ref](xref:mvc/views/razor#ref) attribute to the child component.
837+
* Add an [`@ref`](xref:mvc/views/razor#ref) attribute to the child component.
838838
* Define a field with the same type as the child component.
839839

840840
```cshtml
@@ -1019,7 +1019,7 @@ Optional parameters aren't supported, so two `@page` directives are applied in t
10191019

10201020
Razor components are generated as partial classes. Razor components are authored using either of the following approaches:
10211021

1022-
* C# code is defined in an [@code](xref:mvc/views/razor#code) block with HTML markup and Razor code in a single file. Blazor templates define their Razor components using this approach.
1022+
* C# code is defined in an [`@code`](xref:mvc/views/razor#code) block with HTML markup and Razor code in a single file. Blazor templates define their Razor components using this approach.
10231023
* C# code is placed in a code-behind file defined as a partial class.
10241024

10251025
The following example shows the default `Counter` component with an `@code` block in an app generated from a Blazor template. HTML markup, Razor code, and C# code are in the same file:
@@ -1118,13 +1118,13 @@ The base class should derive from `ComponentBase`.
11181118

11191119
The namespace of a component authored with Razor is based on (in priority order):
11201120

1121-
* [@namespace](xref:mvc/views/razor#namespace) designation in Razor file (*.razor*) markup (`@namespace BlazorSample.MyNamespace`).
1121+
* [`@namespace`](xref:mvc/views/razor#namespace) designation in Razor file (*.razor*) markup (`@namespace BlazorSample.MyNamespace`).
11221122
* The project's `RootNamespace` in the project file (`<RootNamespace>BlazorSample</RootNamespace>`).
11231123
* The project name, taken from the project file's file name (*.csproj*), and the path from the project root to the component. For example, the framework resolves *{PROJECT ROOT}/Pages/Index.razor* (*BlazorSample.csproj*) to the namespace `BlazorSample.Pages`. Components follow C# name binding rules. For the `Index` component in this example, the components in scope are all of the components:
11241124
* In the same folder, *Pages*.
11251125
* The components in the project's root that don't explicitly specify a different namespace.
11261126

1127-
Components defined in a different namespace are brought into scope using Razor's [@using](xref:mvc/views/razor#using) directive.
1127+
Components defined in a different namespace are brought into scope using Razor's [`@using`](xref:mvc/views/razor#using) directive.
11281128

11291129
If another component, `NavMenu.razor`, exists in the *BlazorSample/Shared/* folder, the component can be used in `Index.razor` with the following `@using` statement:
11301130

@@ -1136,7 +1136,7 @@ This is the Index page.
11361136
<NavMenu></NavMenu>
11371137
```
11381138

1139-
Components can also be referenced using their fully qualified names, which doesn't require the [@using](xref:mvc/views/razor#using) directive:
1139+
Components can also be referenced using their fully qualified names, which doesn't require the [`@using`](xref:mvc/views/razor#using) directive:
11401140

11411141
```cshtml
11421142
This is the Index page.
@@ -1265,7 +1265,7 @@ Alternatively, you can specify the `Context` attribute on the component element.
12651265

12661266
### Generic-typed components
12671267

1268-
Templated components are often generically typed. For example, a generic `ListViewTemplate` component can be used to render `IEnumerable<T>` values. To define a generic component, use the [@typeparam](xref:mvc/views/razor#typeparam) directive to specify type parameters:
1268+
Templated components are often generically typed. For example, a generic `ListViewTemplate` component can be used to render `IEnumerable<T>` values. To define a generic component, use the [`@typeparam`](xref:mvc/views/razor#typeparam) directive to specify type parameters:
12691269

12701270
[!code-cshtml[](common/samples/3.x/BlazorWebAssemblySample/Components/ListViewTemplate.razor)]
12711271

aspnetcore/blazor/handle-errors.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ The preceding unhandled exceptions are described in the following sections of th
108108
When Blazor creates an instance of a component:
109109

110110
* The component's constructor is invoked.
111-
* The constructors of any non-singleton DI services supplied to the component's constructor via the [@inject](xref:blazor/dependency-injection#request-a-service-in-a-component) directive or the [[Inject]](xref:blazor/dependency-injection#request-a-service-in-a-component) attribute are invoked.
111+
* The constructors of any non-singleton DI services supplied to the component's constructor via the [`@inject`](xref:blazor/dependency-injection#request-a-service-in-a-component) directive or the [`[Inject]`](xref:blazor/dependency-injection#request-a-service-in-a-component) attribute are invoked.
112112

113113
A circuit fails when any executed constructor or a setter for any `[Inject]` property throws an unhandled exception. The exception is fatal because the framework can't instantiate the component. If constructor logic may throw exceptions, the app should trap the exceptions using a [try-catch](/dotnet/csharp/language-reference/keywords/try-catch) statement with error handling and logging.
114114

@@ -177,7 +177,7 @@ The following conditions apply to error handling with `InvokeAsync<T>`:
177177
* If a call to `InvokeAsync<T>` fails asynchronously, the .NET <xref:System.Threading.Tasks.Task> fails. A call to `InvokeAsync<T>` may fail, for example, because the JavaScript-side code throws an exception or returns a `Promise` that completed as `rejected`. Developer code must catch the exception. If using the [await](/dotnet/csharp/language-reference/keywords/await) operator, consider wrapping the method call in a [try-catch](/dotnet/csharp/language-reference/keywords/try-catch) statement with error handling and logging. Otherwise, the failing code results in an unhandled exception that's fatal to the circuit.
178178
* By default, calls to `InvokeAsync<T>` must complete within a certain period or else the call times out. The default timeout period is one minute. The timeout protects the code against a loss in network connectivity or JavaScript code that never sends back a completion message. If the call times out, the resulting `Task` fails with an <xref:System.OperationCanceledException>. Trap and process the exception with logging.
179179

180-
Similarly, JavaScript code may initiate calls to .NET methods indicated by the [[JSInvokable] attribute](xref:blazor/javascript-interop#invoke-net-methods-from-javascript-functions). If these .NET methods throw an unhandled exception:
180+
Similarly, JavaScript code may initiate calls to .NET methods indicated by the [`[JSInvokable]`](xref:blazor/javascript-interop#invoke-net-methods-from-javascript-functions) attribute. If these .NET methods throw an unhandled exception:
181181

182182
* The exception isn't treated as fatal to the circuit.
183183
* The JavaScript-side `Promise` is rejected.

aspnetcore/blazor/state-management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ To install the `Microsoft.AspNetCore.ProtectedBrowserStorage` package:
150150

151151
### Save and load data within a component
152152

153-
In any component that requires loading or saving data to browser storage, use [@inject](xref:blazor/dependency-injection#request-a-service-in-a-component) to inject an instance of either of the following:
153+
In any component that requires loading or saving data to browser storage, use [`@inject`](xref:blazor/dependency-injection#request-a-service-in-a-component) to inject an instance of either of the following:
154154

155155
* `ProtectedLocalStorage`
156156
* `ProtectedSessionStorage`

aspnetcore/blazor/templates.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ The following files and folders make up a Blazor app generated from a Blazor tem
5353

5454
* *App.razor* &ndash; The root component of the app that sets up client-side routing using the <xref:Microsoft.AspNetCore.Components.Routing.Router> component. The `Router` component intercepts browser navigation and renders the page that matches the requested address.
5555

56-
* *Pages* folder &ndash; Contains the routable components/pages (*.razor*) that make up the Blazor app. The route for each page is specified using the [@page](xref:mvc/views/razor#page) directive. The template includes the following components:
56+
* *Pages* folder &ndash; Contains the routable components/pages (*.razor*) that make up the Blazor app. The route for each page is specified using the [`@page`](xref:mvc/views/razor#page) directive. The template includes the following components:
5757
* `Index` (*Index.razor*) &ndash; Implements the Home page.
5858
* `Counter` (*Counter.razor*) &ndash; Implements the Counter page.
5959
* `Error` (*Error.razor*, Blazor Server app only) &ndash; Rendered when an unhandled exception occurs in the app.
@@ -63,7 +63,7 @@ The following files and folders make up a Blazor app generated from a Blazor tem
6363
* `MainLayout` (*MainLayout.razor*) &ndash; The app's layout component.
6464
* `NavMenu` (*NavMenu.razor*) &ndash; Implements sidebar navigation. Includes the [NavLink component](xref:blazor/routing#navlink-component) (<xref:Microsoft.AspNetCore.Components.Routing.NavLink>), which renders navigation links to other Razor components. The `NavLink` component automatically indicates a selected state when its component is loaded, which helps the user understand which component is currently displayed.
6565

66-
* *_Imports.razor* &ndash; Includes common Razor directives to include in the app's components (*.razor*), such as [@using](xref:mvc/views/razor#using) directives for namespaces.
66+
* *_Imports.razor* &ndash; Includes common Razor directives to include in the app's components (*.razor*), such as [`@using`](xref:mvc/views/razor#using) directives for namespaces.
6767

6868
* *Data* folder (Blazor Server) &ndash; Contains the `WeatherForecast` class and implementation of the `WeatherForecastService` that provide example weather data to the app's `FetchData` component.
6969

aspnetcore/data/ef-rp/intro/samples/cu/wwwroot/lib/bootstrap/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -109,11 +109,11 @@ Editor preferences are available in the [editor config](https://github.com/twbs/
109109

110110
Get updates on Bootstrap's development and chat with the project maintainers and community members.
111111

112-
* Follow [@getbootstrap on Twitter](https://twitter.com/getbootstrap).
112+
* Follow [`@getbootstrap` on Twitter](https://twitter.com/getbootstrap).
113113
* Read and subscribe to [The Official Bootstrap Blog](http://blog.getbootstrap.com).
114114
* Join [the official Slack room](https://bootstrap-slack.herokuapp.com).
115115
* Chat with fellow Bootstrappers in IRC. On the `irc.freenode.net` server, in the `##bootstrap` channel.
116-
* Implementation help may be found at Stack Overflow (tagged [`twitter-bootstrap-3`](https://stackoverflow.com/questions/tagged/twitter-bootstrap-3)).
116+
* Implementation help may be found at Stack Overflow (tagged [twitter-bootstrap-3](https://stackoverflow.com/questions/tagged/twitter-bootstrap-3)).
117117
* Developers should use the keyword `bootstrap` on packages which modify or add to the functionality of Bootstrap when distributing through [npm](https://www.npmjs.com/browse/keyword/bootstrap) or similar delivery mechanisms for maximum discoverability.
118118

119119

aspnetcore/fundamentals/configuration/options.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -162,7 +162,7 @@ Options injection is demonstrated as Example &num;4 in the sample app.
162162
163163
Inject <xref:Microsoft.Extensions.Options.IOptionsMonitor%601> into:
164164
165-
* A Razor page or MVC view with the [@inject](xref:mvc/views/razor#inject) Razor directive.
165+
* A Razor page or MVC view with the [`@inject`](xref:mvc/views/razor#inject) Razor directive.
166166
* A page or view model.
167167
168168
The following example from the sample app injects <xref:Microsoft.Extensions.Options.IOptionsMonitor%601> into a page model (*Pages/Index.cshtml.cs*):
@@ -586,7 +586,7 @@ Options injection is demonstrated as Example &num;4 in the sample app.
586586
587587
Inject <xref:Microsoft.Extensions.Options.IOptionsMonitor%601> into:
588588
589-
* A Razor page or MVC view with the [@inject](xref:mvc/views/razor#inject) Razor directive.
589+
* A Razor page or MVC view with the [`@inject`](xref:mvc/views/razor#inject) Razor directive.
590590
* A page or view model.
591591
592592
The following example from the sample app injects <xref:Microsoft.Extensions.Options.IOptionsMonitor%601> into a page model (*Pages/Index.cshtml.cs*):

aspnetcore/fundamentals/error-handling.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ The endpoint that processes the error can get the original URL that generated th
161161

162162
## Disable status code pages
163163

164-
To disable status code pages for an MVC controller or action method, use the [[SkipStatusCodePages]](xref:Microsoft.AspNetCore.Mvc.SkipStatusCodePagesAttribute) attribute.
164+
To disable status code pages for an MVC controller or action method, use the [`[SkipStatusCodePages]`](xref:Microsoft.AspNetCore.Mvc.SkipStatusCodePagesAttribute) attribute.
165165

166166
To disable status code pages for specific requests in a Razor Pages handler method or in an MVC controller, use <xref:Microsoft.AspNetCore.Diagnostics.IStatusCodePagesFeature>:
167167

aspnetcore/fundamentals/startup.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how the Startup class in ASP.NET Core configures services and
55
monikerRange: '>= aspnetcore-2.1'
66
ms.author: riande
77
ms.custom: mvc
8-
ms.date: 11/02/2019
8+
ms.date: 12/05/2019
99
uid: fundamentals/startup
1010
---
1111
# App startup in ASP.NET Core
@@ -37,7 +37,7 @@ The preceding sample is for [Razor Pages](xref:razor-pages/index); the MVC versi
3737

3838
::: moniker-end
3939

40-
The `Startup` class is specified when the app's [host](xref:fundamentals/index#host) is built. The `Startup` class is typically specified by calling the [`WebHostBuilderExtensions.UseStartup<TStartup>`](xref:Microsoft.AspNetCore.Hosting.WebHostBuilderExtensions.UseStartup*) method on the host builder:
40+
The `Startup` class is specified when the app's [host](xref:fundamentals/index#host) is built. The `Startup` class is typically specified by calling the [WebHostBuilderExtensions.UseStartup\<TStartup>](xref:Microsoft.AspNetCore.Hosting.WebHostBuilderExtensions.UseStartup*) method on the host builder:
4141

4242
::: moniker range="< aspnetcore-3.0"
4343

0 commit comments

Comments
 (0)