KestrelServerOptions Clase

Definición

Proporciona la configuración mediante programación de características específicas de Kestrel.

public ref class KestrelServerOptions
public class KestrelServerOptions
type KestrelServerOptions = class
Public Class KestrelServerOptions
Herencia
KestrelServerOptions

Constructores

KestrelServerOptions()

Propiedades

AddServerHeader

Obtiene o establece si el encabezado Server debe incluirse en cada respuesta.

AllowAlternateSchemes

Obtiene o establece un valor que controla cómo se valida el campo para las solicitudes :scheme HTTP/2 y HTTP/3.

Si es false, el campo para las solicitudes HTTP/2 y HTTP/3 debe coincidir exactamente con el transporte (por ejemplo, https para las conexiones TLS, http para las solicitudes que no son :scheme TLS). Si es true, el campo de las solicitudes :scheme HTTP/2 y HTTP/3 se puede establecer en valores alternativos, lo que se reflejará en HttpRequest.Scheme . El esquema debe seguir siendo válido según https://datatracker.ietf.org/doc/html/rfc3986/#section-3.1 . Habilite esta opción solo cuando trabaje con un proxy de confianza. Esto se puede usar en escenarios como servidores proxy que se convierten desde protocolos alternativos. Vea https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.3. Las aplicaciones que lo habilitan deben validar que se proporciona un esquema esperado antes de usarlo.

AllowResponseHeaderCompression

Obtiene o establece un valor que controla si se permite la compresión dinámica de encabezados de respuesta. Para obtener más información sobre las consideraciones de seguridad de la compresión de encabezado dinámico de HPack, visite https://tools.ietf.org/html/rfc7541#section-7 .

AllowSynchronousIO

Obtiene o establece un valor que controla si se permite la E/S sincrónica para Request y Response

ApplicationSchedulingMode

Obtiene o establece un valor que determina cómo Kestrel debe programar devoluciones de llamada de usuario.

ApplicationServices

Habilita la devolución de llamada de las opciones de escucha para resolver y usar los servicios registrados por la aplicación durante el inicio. Normalmente se inicializa mediante UseKestrel().

ConfigurationLoader

Proporciona un origen de configuración desde el que se cargarán los puntos de conexión al iniciar el servidor. De manera predeterminada, es null.

DisableStringReuse

Obtiene o establece un valor que controla si los valores de cadena materializados se reutilizarán entre solicitudes. si coinciden o si las cadenas siempre se reasignarán.

EnableAltSvc
Obsoleto.

Controla si se debe devolver el encabezado "Alt-Svc" de una respuesta HTTP/2 o inferior para HTTP/3.

Limits

Proporciona acceso a las opciones de límite de solicitudes.

RequestHeaderEncodingSelector

Obtiene o establece una devolución de llamada que devuelve para descodificar el valor del nombre de encabezado de solicitud especificado o para Encoding null usar el valor UTF8Encoding predeterminado.

ResponseHeaderEncodingSelector

Obtiene o establece una devolución de llamada que devuelve para codificar el valor del encabezado de respuesta o nombre de finalizador especificado, o para Encoding null usar el valor ASCIIEncoding predeterminado.

Métodos

Configure()

Crea un cargador de configuración para configurar Kestrel.

Configure(IConfiguration)

Crea un cargador de configuración para configurar Kestrel que toma una IConfiguration como entrada. Esta configuración debe tener como ámbito la sección de configuración de Kestrel. Llame a Configure(IConfiguration, Boolean) para habilitar las actualizaciones de enlace de puntos de conexión dinámicos.

Configure(IConfiguration, Boolean)

Crea un cargador de configuración para configurar Kestrel que toma una IConfiguration como entrada. Esta configuración debe tener como ámbito la sección de configuración de Kestrel.

ConfigureEndpointDefaults(Action<ListenOptions>)

Especifica una acción de configuración que se ejecutará para cada punto de conexión recién creado. Si se vuelve a llamar a , se reemplazará la acción anterior.

ConfigureHttpsDefaults(Action<HttpsConnectionAdapterOptions>)

Especifica una acción de configuración que se ejecutará para cada punto de conexión https recién creado. Si se vuelve a llamar a , se reemplazará la acción anterior.

Listen(EndPoint)

Enlace al punto de conexión especificado.

Listen(EndPoint, Action<ListenOptions>)

Enlace al punto de conexión especificado. La devolución de llamada configura los valores específicos del punto de conexión.

Listen(IPAddress, Int32)

Enlace a una dirección IP y un puerto determinados.

Listen(IPAddress, Int32, Action<ListenOptions>)

Enlace a una dirección IP y un puerto determinados. La devolución de llamada configura los valores específicos del punto de conexión.

Listen(IPEndPoint)

Enlace al punto de conexión IP especificado.

Listen(IPEndPoint, Action<ListenOptions>)

Enlace a una dirección IP y un puerto determinados. La devolución de llamada configura los valores específicos del punto de conexión.

ListenAnyIP(Int32)

Escucha en todas las direcciones IP mediante IPv6 [::] o IPv4 0.0.0.0 si no se admite IPv6.

ListenAnyIP(Int32, Action<ListenOptions>)

Escucha en todas las direcciones IP mediante IPv6 [::] o IPv4 0.0.0.0 si no se admite IPv6.

ListenHandle(UInt64)

Abra un descriptor de archivo de socket.

ListenHandle(UInt64, Action<ListenOptions>)

Abra un descriptor de archivo de socket. La devolución de llamada configura los valores específicos del punto de conexión.

ListenLocalhost(Int32)

Escucha en ::1 y 127.0.0.1 con el puerto dado. No se admite la solicitud de un puerto dinámico especificando 0 para este tipo de punto de conexión.

ListenLocalhost(Int32, Action<ListenOptions>)

Escucha en ::1 y 127.0.0.1 con el puerto dado. No se admite la solicitud de un puerto dinámico especificando 0 para este tipo de punto de conexión.

ListenUnixSocket(String)

Enlace a una ruta de acceso de socket de dominio unix determinada.

ListenUnixSocket(String, Action<ListenOptions>)

Enlace a una ruta de acceso de socket de dominio unix determinada. Especifique la devolución de llamada para configurar opciones específicas del punto de conexión.

Métodos de extensión

UseSystemd(KestrelServerOptions)

Abra descriptores de archivo (a partir de SD_LISTEN_FDS_START) inicializados por la lógica de activación basada en sockets del sistema, si está disponible.

UseSystemd(KestrelServerOptions, Action<ListenOptions>)

Abra descriptores de archivo (a partir de SD_LISTEN_FDS_START) inicializados por la lógica de activación basada en sockets del sistema, si está disponible. Especifique la devolución de llamada para configurar opciones específicas del punto de conexión.

Se aplica a