rpafi/tl enterprise Microsoft Enterprise Library 5.0 Develop Enterprise applications using reusable software

Microsoft

_Enterprise

_Library

_5.0

Develop

Enterprise

applications

using

reusable software

components

of

Microsoft

_{Enterprise Library}

5.0

Sachin Joshi

rpAfi/Tl

enterprise

I I jflv

|\ I

I

professional expertise distilled PUBLISHING

Table

of

Contents

Preface 1

Chapter

1:

_Getting

Started with

_Enterprise

Library 5

Introducing

Enterprise Library 6

Wiring Application Blocks 7

Unity Application

Block 7

Policy Injection Application

Block 7 Functional_Application Blocks 7 Data Access

_Application

Block 8

Logging Application

Block 8

Exception Handling Application Block 8

Caching Application

Block 9

Validation

_Application

Block 9

Security

Application Block 9

Cryptography Application

Block 10

Functional

_Application

Block

_Dependency

10

System requirements

12

Installing Enterprise Library 13

Enterprise

Library

Binaries 13

Configuration

Editor for Visual Studio 13 Source Codeof

_Enterprise

_Library 14

Summary 17

Chapter

2: Data Access

_Application

Block 19

Working

of Data Access_Application Block 20

Developing

an

_application

21

Referencing

the

_required

assemblies 22

Adding

Data Access

_Settings

23

Adding

a namespace 27

Table_ofContents

SqIDatabase class 29

SqICeDatabase class 30 OracleDatabase class 31

GenericDatabase class 31

Creatinga Database instance 32

Usingthe _{DatabaseFactory}class 32

UsingUnityservice locator 33

Using Unitycontainerdirectly 33

Retrieving

records

_using

ExecuteReader 34

Retrieving

records _using DataSet 35

Retrieving a recordas an _object 35

Parameter _mappers 36

Outputmappers 38

Defaultrow_mappers 38 Row_{mapping using MapBuilder} 38

Row_mappingusingIRowMapper<TResult> 38 ResultSet mappers 39

Data Accessors 40

Creating

and _executingAccessors 41

Retrieving multiple recordsas an objectcollection 42

Retrieving records asXML 43

Executing

acommand

using ExecuteNonQuery

44

Retrieving

scalar values 45

Updating

records _using DataSet 46

Working with transactions 48

Summary 50

Chapter 3: Logging

Application

Block 51

Developing

an

_application

53

Referencing

assemblies 53

Adding Logging

Settings 55

Adding

namespaces 57

Writing

a

log

_message 58

Exploring design

elements 60

LogEntry

60

Logger

64

Using Logger 66

LogWriter

66

Adding

tracesource _categories 69

Configuringspecialcategories 70

Configuringlogcategories 71

Configuring

tracelisteners 72

ConfiguringEvent_LogTrace Listener 74

Configuring Rolling Flat File Trace Listener 77

ConfiguringXMLTrace Listener 78

Configuring DatabaseTraceListener 79

Configuringto send_{logmessages to}ane-mailaddress 81

Configuring System DiagnosticsTrace Listener 83 Configuring Message QueuingTrace Listener 84

ConfiguringWMITrace Listener 87

Configuring customtracelisteners 87

Configuring log

message formatters 88

Configuring logging

filters 90

Adding a_categoryfilter 91

Adding alogging enabledfilter 92

Adding a priorityfilter 93

TraceManagerand Tracer 94

Tracingactivities 94

Customizing

Logging

block elements 96

Implementingacustomtrace listener 96

Implementinga custom _logformatter 98

Implementingacustom logfilter 100

Summary

102

Chapter

4:

_{Exception Handling Application}

Block 103

Developing an

_application

104

Referencing required

assemblies 105

Adding

initial

_{Exception Handling settings}

106

Adding

namespaces 108

Understanding

the _{Exception Handling} block 108

Exception policy 108

Exceptiontypes 109

Exceptionhandler 109

Exception Managerclass 111

Stitching together: Exception Policy/Type/Handler

113

Creating

an

_{Exception Handling}

block

_object

113

Usingthe_{ExceptionPolicy} class _.114

Using Unityservice locator 114

Using Unitycontainer_directly 115

Wrapping an_{exception using Wrap}handler 115

Configuring a Wrap

exception

handler 116

Replacing

an

_{exception using}

_Replace handler 118

Configuring

a

Replace

handler 118

Logging an exception using Logginghandler 121

Configuring a _Logging handler 122

WCF fault contract_exception handler 124

Generic fault contract creation 124

Table_ofContents

Applying

the

_{ExceptionShielding}

attribute 126

Exception handling:

WCF Service consumer 126

Implementing custom_exception handler 127

Configuring custom

_exception

handler 128

Summary

129

Chapter 5:

_Caching

Application Block 131

Developing an _application 133

Referencing

the

_required

assemblies 134

Adding the initial Caching Settings 135

Adding

namespaces 137

Creating

the

_CacheManager

instance 137

Usingthe static_factoryclass 138

Usingthe_UnityServiceLocator 139

Usingthe _Unitycontainer_directly 139

Configuring the

_in-memory

_backing store 140

Adding

itemstocache 141

Understandingthe _{expirationprocess} 142

Expiration

policies

143

Understandingthe _{Scavenging process} 143

Reading cached items 144

Removing

cached items 145

Flushing

cached items 145

Reloading expired

items 145

Configuring

Isolated Cache _Storage

_Backing

Store 146

Configuring DatabaseCache

_Storage

148

Configuring

and _encrypting cached data 149

Configuration steps

150

Summary

154

Chapter

6: Validation_Application Block 155 Validation_Application Block features 156

Developing an application 157

Referencing

the

_required

assemblies 158

Adding

namespaces 160

Understanding

Validators 161

Value Validators 161

ObjectValidators ₁₆₃

Single

Member Validators 163

Composite Validators 164

Understanding

Rule Sets 165

Understanding ValidatorFactory

165

Validating objects using

attributes 167

Validating

values _{programmatically} 169

Validating

objects using self-validation 170

Validating objects using configuration 171

Integrating withWindows Forms-based

_applications

179

Steps

to

_leverage

ValidationProvider 180

Integrating

the Validation block with ASP.NET 183

Implementing

a Custom Validator 184

Summary 186

Chapter 7: Security Application Block 187

Developing

an

_application

189

Referencing required/optional

assemblies 190

Adding

initial_{security settings} 191

Addingnamespaces 193

Creating security application

block

_objects

194 Usingthe static_factoryclass 194

Using Unityservice locator 194 UsingUnitycontainer_directly 195

Understanding

Authorization Providers 196 Authorization Rule Provider 197 AzMan Authorization Provider 202

Understanding Security

Cache Provider 203 CachingStoreProviderclass 204

Configuring SecurityCache Provider 204

Cachingand_generatingatokenforanauthenticated user 205

Associating a token with User

Identity,

Principal and Profile

objects

206

RetrievingUser_Identity, User_Principal,and Profile_objects 207

Expiring User_Identity,User_Principal,and Profile_objects 208

Implementing a custom Authorization Provider 210

Custom XMLAuthorization Provider 211

Summary

211

Chapter

8:

_{Cryptography Application}

Block 213

Developing an application 215

Referencing required and _optional assemblies 216

Adding

namespaces 216

Adding

initial

_{cryptography settings}

217

Working

of Hash Provider 219

Creating CryptographyManager

and IHashProvider instances 220 Usingthe static facade 221 UsingUnityservice locator 221

Table_ofContents

Configuring

Hash Provider 222

Generating

a hash value 224

Comparing hash values 224

Implementing a custom Hash Provider 225

ConfiguringaCustom Hash Provider 226

Working

of

_{symmetric cryptography providers}

228

Creating CryptographyManager

and

_{ISymmetricCryptoProvider}

instances 230

Usingthe staticfacade 230

Using Unityservice locator 230

Using Unitycontainer_directly 230

Configuring the _symmetric

_{cryptography provider}

231

Exporting

the

_key

235

Encrypting

data 236

Decrypting

data 236

Implementing

acustom symmetric provider 237

Configuringthe customsymmetricprovider 238

Summary

239

Index 241